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 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.

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

"What trips do I have in Wanderlog?"

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

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

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

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

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

"Move my Rome trip back by two weeks."

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

"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_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_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

1. Go to wanderlog.com and log in
2. Press F12 to open DevTools
3. Click the Application tab
4. In the left sidebar expand Storage → Cookies → https://wanderlog.com
5. Find the row where Name is connect.sid
6. 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

1. Go to wanderlog.com and log in
2. Press F12 to open DevTools
3. Click the Storage tab
4. In the left sidebar expand Cookies → https://wanderlog.com
5. 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

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

{
  "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:

{
  "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:

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

OpenAI Codex

Edit ~/.codex/config.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)

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:

npm run build && npm run test

For changes to transport or tool code, also run:

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