wanderlog-mcp

Un servidor MCP que permite a Claude (o a cualquier agente compatible con MCP) ver y crear itinerarios de viaje en Wanderlog mediante conversación.

En lugar de hacer clic en la interfaz de Wanderlog para planificar un viaje, solo tienes que preguntar:

"Crea una ruta de 14 días por el Golden Route de Japón: Tokio, Hakone, Kioto, Nara y Osaka."

El agente llama a las herramientas, intercala lugares y notas para cada día, añade bloques de hoteles, ferris, autobuses, trenes, coches de alquiler y listas de verificación, y terminas con un viaje completamente poblado en Wanderlog en unos minutos.

Mira un ejemplo real: Ruta de 14 días por el Golden Route de Japón — creado íntegramente por un agente de IA usando este servidor MCP.

Novedades (sin publicar)

• wanderlog_search_hotels — busca en el agregador de hoteles de Wanderlog en airbnb, expedia, google y kayak. Devuelve ofertas clasificadas con comparación de precios por proveedor y descubrimiento de filtros facetados, para que el LLM nunca tenga que memorizar los valores internos de Wanderlog.

• Un intento fallido de autenticación al inicio ahora recibe un reintento compartido en la primera llamada a una herramienta, lo que permite que las sesiones válidas se recuperen de un error transitorio de red o proxy sin reiniciar el servidor.

Related MCP server: kyoto-assistant-mcp

Novedades en v0.3.1

• Wanderlog limita la velocidad de las ediciones rápidas: las mutaciones en ráfaga (un LLM construyendo un itinerario completo) ahora se reintentan automáticamente con retroceso en lugar de fallar con un "Submit op timeout" opaco.

• Los rechazos por límite de velocidad que no se pueden reintentar se muestran como un error claro en lugar de un bloqueo de 10 segundos.

• Las nuevas secciones de día creadas por wanderlog_update_trip_dates ahora coinciden exactamente con la forma nativa de las secciones de Wanderlog.

Novedades en v0.3.0

• wanderlog_search_guides + wanderlog_get_guide — descubre y lee guías de viaje escritas por usuarios en Wanderlog. El LLM puede preguntar "¿qué guías existen para Vietnam?" y extraer itinerarios completos para usarlos como inspiración.

• wanderlog_remove_note — elimina bloques de notas independientes mediante referencia en lenguaje natural.

• wanderlog_edit_note — busca y reemplaza en bloques de notas, anotaciones de lugares y títulos/elementos de listas de verificación.

• El modo detallado ya no trunca las notas de lugares ni los bloques de notas: las guías e itinerarios muestran todo su comentario.

• Correcciones: las notas que contienen incrustaciones ya no se muestran como [object Object]; las referencias a lugares ahora coinciden incluso con diferencias de guiones (por ejemplo, "Roppongi Hills - Tokyo City View").

Novedades en v0.2.0

• wanderlog_rename_day — reemplaza los encabezados de día generados automáticamente (por ejemplo, "Barcelona") por otros descriptivos ("Llegada — Feria de Abril"). Pasa "" para restablecer el valor predeterminado.

• La tabla de herramientas ahora documenta wanderlog_annotate_place y wanderlog_add_expense (publicadas anteriormente, pero ausentes en la documentación de v0.1.0).

Novedades en v0.1.0

• Construcción completa de itinerarios: lugares, notas, hoteles y listas de verificación en una sola conversación

• wanderlog_search_places — encuentra lugares reales cerca de cualquier destino usando la base de datos de lugares de Wanderlog

• wanderlog_add_note — intercala consejos de transporte, información de reservas y consejos locales entre lugares

• wanderlog_add_checklist — listas de verificación previas al viaje y por día (visado, moneda, entradas con horario)

• Instrucciones del servidor MCP inyectadas al inicio para que Claude construya itinerarios completos automáticamente

• Sonda de autenticación al inicio: detecta cookies caducadas inmediatamente en lugar de fallar a mitad de conversación

Ejemplos de 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."

Herramientas

Requisitos previos

• Node.js 22 o superior

• Una cuenta de Wanderlog

• Un cliente compatible con MCP: Claude Code, Claude Desktop, OpenAI Codex, Cursor, VS Code o cualquier host MCP con stdio

Configuración

Paso 1 — Obtén tu cookie de sesión de Wanderlog

Wanderlog no tiene una API pública, por lo que wanderlog-mcp se autentica usando la cookie de sesión de tu navegador (connect.sid). Es válida durante aproximadamente un año y nunca sale de tu máquina.

Trátala como una contraseña — otorga el mismo acceso que tienes en la interfaz de Wanderlog.

Chrome / Edge

1. Ve a wanderlog.com e inicia sesión

2. Pulsa F12 para abrir las herramientas de desarrollador

3. Haz clic en la pestaña Application

4. En la barra lateral izquierda, expande Storage → Cookies → https://wanderlog.com

5. Encuentra la fila donde Name es connect.sid

6. Haz clic en la fila, luego haz doble clic en la celda Value y copia la cadena completa: comienza con s%3A y tiene ~100 caracteres

Firefox

1. Ve a wanderlog.com e inicia sesión

2. Pulsa F12 para abrir las herramientas de desarrollador

3. Haz clic en la pestaña Storage

4. En la barra lateral izquierda, expande Cookies → https://wanderlog.com

5. Encuentra connect.sid en la tabla, haz clic en él y copia el Value

¿Por qué no puedo usar document.cookie en la consola? Wanderlog establece connect.sid con la bandera HttpOnly, que bloquea deliberadamente que JavaScript lo lea (protección contra XSS). Las herramientas de desarrollador evitan esta restricción — por eso funciona y la consola no.

Paso 2 — Configura tu cliente MCP

Claude Code

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

Claude Desktop

Edita 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..."
      }
    }
  }
}

Reinicia Claude Desktop después de guardar.

Cursor

Configuración → MCP → Añadir servidor, o edita ~/.cursor/mcp.json:

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

VS Code (GitHub Copilot)

Añade a tu .vscode/mcp.json del espacio de trabajo:

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

OpenAI Codex

Edita ~/.codex/config.toml:

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

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

Ejecuta /mcp dentro de Codex para confirmar que el servidor se cargó.

Smithery (instalación en un clic)

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

Paso 3 — Verifica

Pregunta a tu agente: "¿Qué viajes tengo en Wanderlog?"

Debería llamar a wanderlog_list_trips y devolver los viajes de tu cuenta. Si falla, consulta Solución de problemas a continuación.

Renovar tu cookie

La cookie dura aproximadamente un año, pero puede caducar antes si cierras sesión en wanderlog.com, cambias tu contraseña o Wanderlog revoca la sesión. Cuando eso ocurre, cada llamada a una herramienta devuelve:

Sesión de Wanderlog inválida o caducada — Captura una cookie connect.sid nueva desde las herramientas de desarrollador de wanderlog.com y actualiza WANDERLOG_COOKIE en tu configuración de MCP.

Repite el Paso 1 anterior, actualiza tu configuración y reinicia tu cliente MCP.

Solución de problemas

El servidor arranca pero list_trips devuelve un error de autenticación Tu cookie está caducada o es incorrecta. Vuelve a capturarla desde las herramientas de desarrollador y actualiza tu configuración.

npx wanderlog-mcp se cuelga o no hace nada El servidor habla MCP por stdio — está diseñado para ser lanzado por un host MCP, no para ejecutarse directamente en una terminal. Ejecútalo a través de Claude Code o Claude Desktop como se describe arriba.

Las herramientas funcionan pero el agente ignora notas/listas de verificación El servidor inyecta instrucciones en la respuesta de initialize de MCP que le dicen al agente que intercale lugares y notas y añada listas de verificación. Esto funciona de manera fiable con Claude. Otros clientes pueden variar.

Seguridad

• La cookie se almacena únicamente en la configuración de tu cliente MCP; nunca se hace commit ni se registra

• wanderlog-mcp se ejecuta íntegramente en tu máquina: no hay ningún servidor de retransmisión

• La comprobación de autenticación al inicio valida tu cookie sin imprimir su valor

• Para revocar el acceso: cierra sesión en wanderlog.com (invalida todas las sesiones) y vuelve a capturarla

Contribuciones

Las pull requests son bienvenidas. Antes de enviarlas:

npm run build && npm run test

Para cambios en el código de transporte o de herramientas, ejecuta también:

npm run test:integration

Aviso legal

wanderlog-mcp es una herramienta no oficial de terceros, sin afiliación ni respaldo de Wanderlog. Funciona mediante llamadas a la API privada del cliente web de Wanderlog, que puede cambiar sin previo aviso. Úsalo bajo tu propio riesgo.

Licencia

MIT — consulta LICENSE

Hecho por shaikhspeare