# shaikhspeare/wanderlog-mcp [Health: Active]

**Category:** 🚆 Travel & Transportation  
**Repository:** https://github.com/shaikhspeare/wanderlog-mcp  
**GitHub Stars:** 127  
**npm Downloads (last month):** 800  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/shaikhspeare-wanderlog-mcp

## Description
MCP server for Wanderlog that lets AI clients read and edit trip itineraries through natural language, including trips, places, notes, hotels, checklists, and date updates.

## Tools
Capabilities this server exposes over MCP:

- **wanderlog_list_trips** — List trips in your account
- **wanderlog_get_trip** — View a full itinerary, or filter to a single day
- **wanderlog_get_trip_url** — Get a shareable wanderlog.com link
- **wanderlog_get_trip_forwarding_email** — Get a trip's `trip+<id>@wanderlog.com` import address
- **wanderlog_search_places** — Find real-world places near a trip's destination
- **wanderlog_search_guides** — List user-written travel guides for a destination, with fallback suggestions when none exist
- **wanderlog_get_guide** — Read the full content of a public Wanderlog guide (sections, places, notes)
- **wanderlog_search_hotels** — Search Wanderlog's hotel aggregator (airbnb/expedia/google/kayak) with per-vendor deal comparison
- **wanderlog_create_trip** — Create a new trip with destination + date range
- **wanderlog_add_place** — Add a place to a specific day or general list
- **wanderlog_add_note** — Add a note (transit tips, booking info, local advice)
- **wanderlog_edit_note** — Find-and-replace text in notes, place annotations, and checklists
- **wanderlog_remove_note** — Remove a standalone note block by natural-language reference
- **wanderlog_add_hotel** — Add a hotel booking with check-in/check-out dates
- **wanderlog_add_transit** — Add a ferry, bus, or train leg (carrier, from/to, dates/times) to the shared Transit section
- **wanderlog_add_car_rental** — Add a rental car with pick-up/drop-off locations and times
- **wanderlog_add_checklist** — Add a pre-trip or per-day checklist
- **wanderlog_add_expense** — Log a budget expense (amount, category, currency), optionally linked to a place
- **wanderlog_list_expenses** — List budget expenses, optionally filtered by description / date / amount / currency
- **wanderlog_remove_expense** — Remove a budget expense by description (with optional date / amount / currency filters)
- **wanderlog_edit_expense** — Change a budget expense's description, amount, currency, category, or date
- **wanderlog_annotate_place** — Update an existing place with a note, start/end time, or both
- **wanderlog_remove_place** — Remove a place by natural-language reference
- **wanderlog_move_block** — Move an existing place or reservation block within its current section
- **wanderlog_update_trip_dates** — Change a trip's date range
- **wanderlog_rename_day** — Rename a day's heading (e.g. `"Barcelona"` → `"Arrival — Feria de Abril"`)
- **wanderlog_list_journal** — List journal (travelogue) stops, optionally filtered by title or date
- **wanderlog_add_journal** — Add a journal stop: a place + date/time + text entry
- **wanderlog_edit_journal** — Edit a journal stop's title, text, or date/time (or the journal summary)
- **wanderlog_remove_journal** — Remove a journal stop by title (with an optional date filter)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "wanderlog-mcp": {
    "command": "npx",
    "args": ["-y","wanderlog-mcp"],
    "env": {
      "WANDERLOG_COOKIE": ""
    }
  }
}
```

**Requires environment variables:** `WANDERLOG_COOKIE` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What shaikhspeare/wanderlog-mcp MCP server does

shaikhspeare/wanderlog-mcp MCP server connects an MCP-compatible agent to a Wanderlog account for itinerary reading and editing. It covers trip discovery, detailed itinerary retrieval, share links, forwarding addresses, destination place search, public travel-guide lookup, and hotel searches. Editing operations can create trips and add or remove itinerary items such as places, notes, hotels, transport legs, car rentals, checklists, expenses, and journal entries.

The server is suited to conversational trip planning. An agent can create a trip with a destination and date range, populate days with places and practical notes, add transportation or lodging details, and later adjust dates or rename day headings. It also supports reviewing and maintaining budget expenses and travel-journal content.

## How it works

The project runs as a local stdio MCP server and uses a Wanderlog browser session cookie for authentication because Wanderlog does not provide a public API. The required cookie is named `connect.sid`. It is copied from the browser's developer tools after signing in to Wanderlog, then passed to the MCP process as an environment variable.

The cookie grants the same account access available in the Wanderlog website, so it should be handled like a password. The README states that the cookie remains on the user's machine and is generally valid for about a year. Startup authentication checks can identify expired cookies, and a transient startup failure receives a shared retry on the first tool call. Rapid itinerary edits are retried with backoff when Wanderlog rate-limits requests.

## Setup and configuration

shaikhspeare/wanderlog-mcp MCP server requires Node.js 22 or newer, a Wanderlog account, and an MCP client that supports stdio servers. The repository documents use with Claude Code and lists Claude Desktop, OpenAI Codex, Cursor, and VS Code as compatible MCP hosts.

Configure the server with the `WANDERLOG_COOKIE` environment variable. To obtain its value, sign in at wanderlog.com, open browser developer tools, inspect cookies for `https://wanderlog.com`, and copy the value for `connect.sid`. In Chrome or Edge, this is under Application and Storage; in Firefox, it is under Storage and Cookies. The cookie is HttpOnly, so it cannot be read with `document.cookie`.

A package-runner configuration can invoke the published `wanderlog-mcp` package with Node.js. The client configuration must supply the cookie value; no API key is documented.

## Tools and capabilities

The available tools include:

- List trips, retrieve a complete itinerary or one day, and return a shareable Wanderlog URL or trip import email.
- Search places near a destination, public user-written guides, and hotel offers from Airbnb, Expedia, Google, and Kayak.
- Create trips and add places, notes, hotels, ferries, buses, trains, rental cars, and checklists.
- Find and replace note content across notes, place annotations, and checklist titles or items.
- Add, edit, list, and remove budget expenses with optional filters and place links.
- Annotate or remove places, change trip dates, and rename day headings.
- List, add, edit, and remove journal stops, including journal summaries and date or time data.

## Limitations and notes

The server depends on a valid Wanderlog browser session cookie rather than a public API credential. Losing or expiring that session requires obtaining a new cookie. The cookie provides account-level access, so it should not be shared or committed to configuration files. Hotel results come from Wanderlog's aggregator and include vendor comparisons, while guide retrieval applies to public Wanderlog guides. The project requires a local Node.js runtime and an MCP-compatible client; the provided material does not describe a hosted endpoint.

_Full upstream README: https://allmcps.com/mcp/shaikhspeare-wanderlog-mcp/readme_