{
  "markdown": "<p align=\"center\"><img src=\"assets/logo-400.png\" width=\"120\" alt=\"Trvlrr\"></p>\n\n# Trvlrr MCP server\n\n**Your travel journal in any AI assistant.** Connect [Trvlrr](https://trvlrr.app) to Claude,\nChatGPT, Cursor, Raycast or any app that speaks the\n[Model Context Protocol](https://modelcontextprotocol.io), and ask about every trip you've\ntaken and the ones you're planning — flights, trains, stays, activities and expenses — see your\nlifetime travel stats, find photos by describing them, add a booking by pasting it, or import a\nwhole trip from another app.\n\n```\nhttps://trvlrr.app/mcp\n```\n\nA hosted, remote server (Streamable HTTP). There's nothing to install and no API key: the first\ntime a tool is used you sign in to your own Trvlrr account in the browser and approve the\nconnection. You can disconnect it any time from **Profile → Connected apps** in Trvlrr.\n\n> This repository holds connection instructions and configuration only. The Trvlrr service and\n> its server code are not here.\n\n## Try asking\n\n- \"Which countries have I been to, and how many trips have I taken?\"\n- \"Where are we staying in Kyoto, and when do we fly home?\"\n- \"Add this hotel confirmation to my Japan trip.\"\n- \"Find my photo of the Rialto Bridge.\" *(Trvlrr Plus)*\n- \"Plan a relaxed day in Hakone around what we've booked.\"\n- \"Bring this itinerary across from my notes.\"\n\n## Connect it\n\n| App | How |\n|---|---|\n| **Claude** | Listed in Claude's connector directory: Settings → Connectors → Discover → **Trvlrr** ([listing](https://claude.ai/directory/connectors/trvlrr)). |\n| **ChatGPT** | Add as a plugin with the URL above (Developer mode, on Plus, Pro, Business, Enterprise and Edu). |\n| **Claude Code** | `claude mcp add --transport http trvlrr https://trvlrr.app/mcp` |\n| **Cursor** | Settings → MCP → Add server, or add `mcp.json` from this repo to `~/.cursor/mcp.json`. |\n| **VS Code** | Command palette → *MCP: Add Server* → HTTP → `https://trvlrr.app/mcp` |\n| **Gemini CLI** | `gemini extensions install https://github.com/sanjaybhagia/trvlrr-mcp` |\n| **Raycast** | In the *Model Context Protocol Registry* extension, under official servers. |\n| **Anything else** | Point it at `https://trvlrr.app/mcp`; for stdio-only apps use `npx -y mcp-remote https://trvlrr.app/mcp` (see [llms-install.md](llms-install.md)). |\n\nStep-by-step guides, with screenshots of where each setting lives: **[trvlrr.app/assistants](https://trvlrr.app/assistants)**.\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `list_trips` | Every trip, newest first: dates, status, places, travellers, photo count. |\n| `get_trip` | One trip in full — transport, stays, activities, documents; optionally costs, packing list and photos. |\n| `get_stats` | Lifetime numbers over trips that have happened: countries, cities, flights, distance, days away. |\n| `search_photos` | Find photos by describing them. *Trvlrr Plus.* |\n| `get_file` | Open a photo or a trip document such as an e-ticket. |\n| `import_trip` | Bring in a whole trip with its transport, stays, activities and expenses. |\n| `save_items` | Add or update transport, stays, activities, expenses, packing items or places. |\n| `update_trip` | Change a trip's details, merge two trips, settle flagged cancellations. |\n| `update_profile` | The travel profile, the homes you've lived in, and the people you travel with. |\n| `delete_items` | Permanently delete trips or items, after the person confirms. |\n\nEvery tool has annotations (read-only or destructive) and an output schema. Trvlrr can't book\nor pay for travel, check anyone in, or sign in to airline, hotel or email accounts.\n\n## Plans\n\nConnecting and asking about your trips are free. On the free plan, importing trips and adding\nitems through an assistant counts towards three imports a month, shared with forwarded booking\nemails. [Trvlrr Plus](https://trvlrr.app/pricing) has no monthly limit and adds photo search\nand packing lists.\n\n## Auth details\n\n- OAuth 2.1, PKCE (S256), public clients\n- Dynamic client registration at `https://trvlrr.app/oauth/register`, and client ID metadata\n  documents\n- Discovery: `https://trvlrr.app/.well-known/oauth-protected-resource` and\n  `https://trvlrr.app/.well-known/oauth-authorization-server`\n- Access tokens last an hour; refresh tokens rotate\n- Official MCP Registry name: `app.trvlrr/trvlrr` ([server.json](server.json))\n\n## Links\n\n[trvlrr.app](https://trvlrr.app) · [Claude & ChatGPT](https://trvlrr.app/features/ai-assistant) ·\n[Privacy](https://trvlrr.app/privacy) · [Terms](https://trvlrr.app/terms) ·\n[Support](https://trvlrr.app/support) · support@trvlrr.app · Trvlrr for\n[iPhone](https://apps.apple.com/app/id6807719584)\n\nMade in Sydney by Arigato Consulting Pty Ltd. The files in this repository are MIT licensed;\nsee [LICENSE](LICENSE).\n",
  "bytes": 4760,
  "sha": "7fdce88a393e5fb0a2c63d56b74cc92c73b80336c44bf25627eba099d8326436",
  "repo_slug": "sanjaybhagia/trvlrr-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/plg_sanjaybhagia_trvlrr_mcp_46d05e92/readme"
}