# Connect TravelDay to your AI > TravelDay runs a remote MCP server at `https://www.travelday.world/api/mcp`. Add that URL to ChatGPT, Claude, Cursor, VS Code or any MCP client, sign in to TravelDay, and approve what it may do. Importing your travel from email is free on every plan. Asking questions about your travel needs TravelDay Plus. Last updated: 2026-10-07 - **Server URL:** `https://www.travelday.world/api/mcp` - **Transport:** Streamable HTTP. - **Sign-in:** OAuth 2.1 with PKCE. There is no API key. Clients register automatically (CIMD or dynamic registration). - **Protocol versions:** 2025-03-26, 2025-06-18, 2025-11-25, 2026-07-28. - **Price:** import tools are free. Questions, edits and analysis need [Plus](https://www.travelday.world/pricing). - **Disconnect:** Settings, Connected apps, in TravelDay. One click ends the connection. - **MCP Registry name:** `world.travelday/travelday` ## What it does Your assistant gets the same tools as the assistant inside TravelDay. It answers from your real travel record instead of guessing. - Import flights, hotels, rentals, trains, buses and ferries from your own email. - Count days per country and check visa windows like Schengen 90/180. - List visits, flights and trips, and summarise your travel by year. - Add or correct a trip or visit, with your approval. - Read safety scores and advisories for a destination. ## What is free and what needs Plus On the free plan your AI can **import**. With Plus it can **import and answer questions** about your trips, days and visas. Free on every account: `get_import_playbook`, `propose_email_bookings_for_review`, `propose_add_email_bookings_to_history`, `summarize_travel`, `get_travel_story`. That is enough to import your travel from email, hear what was added and read back your travel story. Everything else over MCP needs TravelDay Plus: questions about your days, visas and taxes, edits, flights, trips and safety. Your imported history stays free to view and export in TravelDay, whatever plan you are on. ## Set up your assistant ### ChatGPT Web, on a paid plan. Workspaces may need an admin to allow custom apps. 1. On chatgpt.com, open **Settings**, then **Security and login**, and turn on **Developer mode**. 2. Go to [chatgpt.com/plugins](https://chatgpt.com/plugins) and press **+** to add a custom MCP server. 3. Name it **TravelDay** and paste `https://www.travelday.world/api/mcp` as the server URL. Leave authentication on **OAuth**. 4. Sign in to TravelDay and approve. Approve **Write** too if you want to import. 5. Start a new chat, turn on TravelDay in the tools menu, and ask: "Use TravelDay to tell me how many countries I have visited." Write actions depend on your ChatGPT plan and workspace policy. If the menus differ, follow [OpenAI's setup guide](https://developers.openai.com/plugins/deploy/connect-chatgpt). ### Claude (web and desktop) Any plan. One connection covers claude.ai, Claude Desktop, Claude mobile and Claude Code. 1. Open **Settings**, then **Connectors**, and choose **Add custom connector**. 2. Name it **TravelDay** and paste `https://www.travelday.world/api/mcp`. 3. Sign in to TravelDay and approve the permissions you want. 4. In a chat, press **+**, turn on TravelDay, and ask a travel question. Install link: https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=TravelDay&connectorUrl=https%3A%2F%2Fwww.travelday.world%2Fapi%2Fmcp ### Claude Code The terminal agent. Connectors you added on claude.ai also appear here when you use the same account. 1. Add the server: ``` claude mcp add --transport http travelday https://www.travelday.world/api/mcp ``` 2. Run `/mcp` inside Claude Code, choose **travelday**, and sign in when the browser opens. 3. Optional: unzip the [email import skill](https://www.travelday.world/docs/mcp/travelday-email-import.zip) into `~/.claude/skills/`. ### Cursor Desktop editor. Works in Agent chat. 1. Use the install link below, or add this to `~/.cursor/mcp.json`: ``` { "mcpServers": { "travelday": { "url": "https://www.travelday.world/api/mcp" } } } ``` 2. Open Cursor Settings, find TravelDay under MCP, and sign in when asked. 3. Ask in Agent chat: "Use TravelDay to list my trips this year." Install link: cursor://anysphere.cursor-deeplink/mcp/install?name=travelday&config=eyJ1cmwiOiJodHRwczovL3d3dy50cmF2ZWxkYXkud29ybGQvYXBpL21jcCJ9 ### VS Code (GitHub Copilot) Copilot Chat in Agent mode. 1. Use the install link below, run **MCP: Add Server** from the Command Palette and choose HTTP, or add this to `.vscode/mcp.json`: ``` { "servers": { "travelday": { "type": "http", "url": "https://www.travelday.world/api/mcp" } } } ``` 2. Start the server when VS Code offers, and sign in to TravelDay in the browser. 3. Open Copilot Chat in **Agent** mode and ask a travel question. Install link: vscode:mcp/install?%7B%22name%22%3A%22travelday%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fwww.travelday.world%2Fapi%2Fmcp%22%7D ### Grok Web, free tier included. Business accounts need an admin to add it. 1. Go to [grok.com/connectors](https://grok.com/connectors). 2. Choose **New Connector**, then **Custom**. 3. Paste `https://www.travelday.world/api/mcp`, save, then sign in to TravelDay and approve. ### Any other MCP client OpenClaw, Gemini CLI, Codex, Windsurf and others. 1. Find **MCP servers**, **Connectors** or **Integrations** and add a remote server. 2. Paste `https://www.travelday.world/api/mcp`. Choose **Streamable HTTP** if asked for a transport, and **OAuth** if asked for auth. 3. Complete the TravelDay sign-in in your browser. There is no API key. A client asking for one is set up for a different kind of server. 4. A typical JSON config looks like this: ``` { "mcpServers": { "travelday": { "type": "http", "url": "https://www.travelday.world/api/mcp" } } } ``` OpenClaw: see the [OpenClaw MCP guide](https://docs.openclaw.ai/cli/mcp). ## Import your travel from email Your assistant reads your mail through its own Gmail or Outlook connection. TravelDay never touches your mailbox. The assistant sends TravelDay the travel facts it found, nothing else. 1. Connect your mail to the same assistant: Gmail or Outlook in ChatGPT, Gmail or Microsoft 365 in Claude. 2. Connect TravelDay as above, with **Write** approved. 3. Say: "Import my travel from email into TravelDay." In Claude and Claude Code you can also pick the **Import my travel from email** prompt. 4. The assistant reads TravelDay's import rules first, searches by airline, hotel and travel-agency senders, and sends bookings in batches. 5. Approve when asked. Confident past flights and stays go into your history; anything uncertain waits in your review list in TravelDay. 6. Check the result in TravelDay. Each import is labelled with the assistant that sent it and can be undone in one tap. ## What your assistant sends, and what it never sends Unknown fields are rejected by the server, so a body or attachment cannot be sent even by mistake. Sent: - Booking type and status (confirmed, changed, cancelled, declined) - Provider, sender domain and booking reference - The email's date and subject line - Traveller names as printed - Flights: airport codes, flight number, local dates and times - Stays: check-in and check-out dates, city, country and property name - Trains, buses and ferries: stations, cities and local dates Never sent: - Email bodies, HTML, snippets or attachments - Links, prices, card or payment details - Passport, loyalty or phone numbers, or addresses - Any email that is not a travel booking ## You stay in control - TravelDay asks you directly before writing to your history, in clients that support it. Other clients show their own confirmation first. - Bookings that are uncertain, cancelled, or for someone else go to your review list. Nothing there counts until you approve it. - Every import is labelled with the assistant that sent it, and one tap undoes the whole batch. - Resending is safe. Bookings are matched on reference and dates, including against TravelDay's own inbox scan. - Limits: up to 25 bookings per call and 40 calls a day. - Email content is treated as data, never as instructions. ## Permissions you can grant You choose what to grant on TravelDay's approval screen. Each permission is separate. - **Read** (`travel:read`): travel history, day counts, trips, saved places and safety data. - **Write** (`travel:write`): add or correct trips and visits. Needed for imports. - **Delete** (`travel:delete`): remove trips and visits. Always asks first. - **Evidence** (`travel:evidence`): search travel email TravelDay already holds and read evidence you select. - **Journal** (`travel:journal`): your private travel stories. Never included in the others. - No permission opens your document vault, contacts anyone, or triggers SOS. ## Email import skill For the most consistent imports, install the [travelday-email-import skill](https://www.travelday.world/docs/mcp/travelday-email-import.zip). It holds the full search and extraction rules. **Claude:** Customize, then Skills, then upload the zip. Code execution must be on. **Claude Code and Cursor:** unzip into `~/.claude/skills/`. **ChatGPT:** the rules arrive through the TravelDay tools, no upload needed. No skill? It still works. The import tools hand your assistant the same rules on first use. ## If it will not connect - Paste the full URL, `https://www.travelday.world/api/mcp`, with **www** and `/api/mcp`. Not `/mcp` or `/docs/mcp`. - Asked for an API key? Pick OAuth instead. TravelDay has no keys. - After signing in you should see TravelDay's approval screen. If you land on the map instead, reopen the connection from your assistant. - "Added" can mean saved but not signed in. Start a new chat and ask "Use TravelDay to tell me how many countries I have visited." - "Plus is required" means the tool is not an import tool. Imports work on a free account. - Corporate proxies can block the sign-in. Try a personal network. - Still stuck? Email [support@travelday.world](mailto:support@travelday.world) with the assistant's name and the error. ## Prompt for an AI agent Paste this into any assistant that can add MCP servers, or hand it to an agent told to connect TravelDay. ``` Connect TravelDay as a remote MCP server. Server URL: https://www.travelday.world/api/mcp Transport: Streamable HTTP. Auth: OAuth 2.1 (browser sign-in, no API key). If you cannot add servers yourself, give me the exact steps for this app from https://www.travelday.world/docs/mcp. Once connected, call get_import_playbook before any import and follow its rules. Then search my email for travel bookings and send them to TravelDay. Send only booking facts, never email bodies or attachments, and show me a summary before you send. ``` ## Questions ### What is the TravelDay MCP server? It is a remote Model Context Protocol server at `https://www.travelday.world/api/mcp`. It lets AI assistants such as ChatGPT, Claude, Cursor and VS Code read and update your TravelDay travel record after you sign in and approve. ### Is connecting my AI to TravelDay free? Importing your travel from email through your assistant is free on every plan. Asking it questions about your travel, editing your history and the other tools need TravelDay Plus. ### Do I need an API key? No. TravelDay uses OAuth sign-in. Your assistant opens a TravelDay sign-in page and you approve the connection there. ### Can TravelDay read my email through my assistant? No. Your assistant reads your mail with its own connection and sends TravelDay only booking facts: dates, airports, booking references, providers and traveller names. Email bodies, attachments and payment details are refused by the server. ### Can I undo an import? Yes. Every import is labelled with the assistant that made it, and one tap undoes the whole batch. Uncertain bookings wait in your review list until you approve them. ### How do I disconnect an assistant? In TravelDay, open Settings, then Connected apps, and end the connection. It stops working immediately. ## Machine-readable - [This guide as markdown](https://www.travelday.world/docs/mcp.md) - [llms.txt](https://www.travelday.world/llms.txt) - [llms-full.txt](https://www.travelday.world/llms-full.txt) - [MCP server card](https://www.travelday.world/api/mcp/server-card) - [AI catalog](https://www.travelday.world/.well-known/ai-catalog.json) - [OAuth protected-resource metadata](https://www.travelday.world/.well-known/oauth-protected-resource/api/mcp) - [Agent guide](https://www.travelday.world/docs/agents.md)