wanderlog-mcp

An MCP server that lets Claude (or any MCP-compatible agent) view and build Wanderlog trip itineraries through conversation.

Instead of clicking through the Wanderlog UI to plan a trip, you just ask:

"Create a 14-day Japan Golden Route trip — Tokyo, Hakone, Kyoto, Nara, and Osaka."

The agent calls the tools, interleaves places and notes for each day, adds hotel blocks, ferries, buses, trains, rental cars, and checklists, and you end up with a fully populated Wanderlog trip in a few minutes.

See a real example: 14-day Japan Golden Route — built entirely by an AI agent using this MCP server.

What's New (Unreleased)

wanderlog_search_hotels — search Wanderlog's hotel aggregator across airbnb, expedia, google, and kayak. Returns ranked offers with per-vendor price comparison and faceted filter discovery so the LLM never has to memorise Wanderlog's internal enum values.
A failed startup authentication probe now gets one shared retry on the first tool call, allowing valid sessions to recover from a transient network or proxy error without restarting the server.

What's New in v0.3.1

Wanderlog rate-limits rapid edits — burst mutations (an LLM building a full itinerary) now retry automatically with backoff instead of failing with an opaque "Submit op timeout".
Rate-limit rejections that can't be retried surface as a clear error instead of a 10-second hang.
New day sections created by wanderlog_update_trip_dates now match Wanderlog's native section shape exactly.

What's New in v0.3.0

wanderlog_search_guides + wanderlog_get_guide — discover and read user-written Wanderlog travel guides. The LLM can ask "what guides exist for Vietnam?" and pull full itineraries to use as inspiration.
wanderlog_remove_note — remove standalone note blocks by natural-language reference.
wanderlog_edit_note — find-and-replace across note blocks, place annotations, and checklist titles/items.
Detailed mode no longer truncates place notes or note blocks — guides and itineraries render their full commentary.
Fixes: notes containing embeds no longer render as [object Object]; place references now match across hyphen/dash differences (e.g. "Roppongi Hills - Tokyo City View").

What's New in v0.2.0

wanderlog_rename_day — replace auto-generated day headings (e.g. "Barcelona") with descriptive ones ("Arrival — Feria de Abril"). Pass "" to reset back to the default.
Tools table now documents wanderlog_annotate_place and wanderlog_add_expense (shipped previously, missing from v0.1.0 docs).

What's New in v0.1.0

Full itinerary building: places, notes, hotels, and checklists in a single conversation
wanderlog_search_places — find real-world places near any destination using Wanderlog's place database
wanderlog_add_note — interleave transit tips, booking info, and local advice between places
wanderlog_add_checklist — pre-trip and per-day checklists (visa, currency, timed-entry tickets)
MCP server instructions injected at startup so Claude builds complete itineraries automatically
Startup auth probe — catches expired cookies immediately instead of failing mid-conversation

Example Prompts

Code

"What trips do I have in Wanderlog?"

Code

"Create a 7-day itinerary for Lisbon starting June 1 — include restaurants, day trips,
and a hotel near the waterfront."

Code

"Add a day trip to Sintra on day 3 of my Lisbon trip."

Code

"I'm spending 5 days in Tokyo — build me a full itinerary with museum visits, ramen spots,
and a ryokan in Shinjuku."

Code

"Look at my Barcelona trip and add practical notes for getting between each place."

Code

"Add a pre-trip checklist to my Paris trip — visa, currency, offline maps, travel insurance."

Code

"Move my Rome trip back by two weeks."

Code

"Give me the shareable link to my Kyoto itinerary."

Code

"Remove the Colosseum from day 2 of my Rome trip."

Tools

Tool	What it does
`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)

Prerequisites

Node.js 22 or newer
A Wanderlog account
An MCP-compatible client: Claude Code, Claude Desktop, OpenAI Codex, Cursor, VS Code, or any stdio MCP host

Setup

Step 1 — Get your Wanderlog session cookie

Wanderlog doesn't have a public API, so wanderlog-mcp authenticates using your browser session cookie (connect.sid). It's valid for roughly a year and never leaves your machine.

Treat it like a password — it grants the same access you have in the Wanderlog UI.

Chrome / Edge

Go to wanderlog.com and log in
Press F12 to open DevTools
Click the Application tab
In the left sidebar expand Storage → Cookies → https://wanderlog.com
Find the row where Name is connect.sid
Click the row, then double-click the Value cell and copy the full string — it starts with s%3A and is ~100 characters long

Firefox

Go to wanderlog.com and log in
Press F12 to open DevTools
Click the Storage tab
In the left sidebar expand Cookies → https://wanderlog.com
Find connect.sid in the table, click it, and copy the Value

Why can't I use document.cookie in the console? Wanderlog sets connect.sid with the HttpOnly flag, which deliberately blocks JavaScript from reading it (XSS protection). DevTools bypasses this restriction — that's why it works and the console doesn't.

Step 2 — Configure your MCP client

Claude Code

Terminal

claude mcp add wanderlog-mcp npx wanderlog-mcp \
  --env WANDERLOG_COOKIE="s%3A...your value here..."

Claude Desktop

Edit claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

config.json

{
  "mcpServers": {
    "wanderlog": {
      "command": "npx",
      "args": ["wanderlog-mcp"],
      "env": {
        "WANDERLOG_COOKIE": "s%3A...your value here..."
      }
    }
  }
}

Restart Claude Desktop after saving.

Cursor

Settings → MCP → Add server, or edit ~/.cursor/mcp.json:

config.json

{
  "mcpServers": {
    "wanderlog": {
      "command": "npx",
      "args": ["wanderlog-mcp"],
      "env": {
        "WANDERLOG_COOKIE": "s%3A...your value here..."
      }
    }
  }
}

VS Code (GitHub Copilot)

Add to your workspace .vscode/mcp.json:

config.json

{
  "servers": {
    "wanderlog": {
      "type": "stdio",
      "command": "npx",
      "args": ["wanderlog-mcp"],
      "env": {
        "WANDERLOG_COOKIE": "s%3A...your value here..."
      }
    }
  }
}

OpenAI Codex

Edit ~/.codex/config.toml:

toml

[mcp_servers.wanderlog]
command = "npx"
args = ["wanderlog-mcp"]

[mcp_servers.wanderlog.env]
WANDERLOG_COOKIE = "s%3A...your value here..."

Run /mcp inside Codex to confirm the server loaded.

Smithery (one-click install)

Terminal

npx @smithery/cli install wanderlog-mcp --client claude

Step 3 — Verify

Ask your agent: "What trips do I have in Wanderlog?"

It should call wanderlog_list_trips and return your account's trips. If it fails, see Troubleshooting below.

Refreshing your cookie

The cookie lasts about a year but can die sooner if you log out of wanderlog.com, change your password, or Wanderlog revokes the session. When that happens every tool call returns:

Wanderlog session invalid or expired — Capture a fresh connect.sid cookie from wanderlog.com DevTools and update WANDERLOG_COOKIE in your MCP config.

Repeat Step 1 above, update your config, and restart your MCP client.

Troubleshooting

Server starts but list_trips returns an auth error Your cookie is expired or wrong. Re-capture it from DevTools and update your config.

npx wanderlog-mcp hangs or does nothing The server speaks stdio MCP — it's designed to be launched by an MCP host, not run directly in a terminal. Run it through Claude Code or Claude Desktop as described above.

Tools work but the agent ignores notes/checklists The server injects instructions into the MCP initialize response that tell the agent to interleave places and notes and add checklists. This works reliably with Claude. Other clients may vary.

Security

The cookie is stored only in your MCP client config, never committed or logged
wanderlog-mcp runs entirely on your machine — there's no relay server
The startup auth probe validates your cookie without printing its value
To revoke access: log out of wanderlog.com (invalidates all sessions), then re-capture

Contributing

Pull requests are welcome. Before submitting:

Terminal

npm run build && npm run test

For changes to transport or tool code, also run:

Terminal

npm run test:integration

Disclaimer

wanderlog-mcp is an unofficial third-party tool, not affiliated with or endorsed by Wanderlog. It works by calling Wanderlog's private web-client API, which may change without notice. Use at your own risk.

License

MIT — see LICENSE

Made by shaikhspeare