Connect AI apps to Bundle
The Bundle connector lets AI apps like Claude, ChatGPT and Cursor read and work with your messages, pages, calendar and mail. It uses MCP (Model Context Protocol), an open standard many AI apps support. You sign in with your Bundle account, pick one workspace and choose what the app is allowed to do.
Connector URL
https://app.bundle.direct/mcp It's a remote MCP server (Streamable HTTP) with OAuth sign-in. You don't need an API key.
Claude (web and desktop)
- Open Settings → Connectors and click Add custom connector.
- Name it Bundle, paste the URL above and click Add.
- Click Connect, sign in to Bundle, pick a workspace and what Claude can do, then click Allow.
On a Team or Enterprise plan, an owner of your Claude organization may need to add the connector first.
Claude Code
Run this in your terminal:
claude mcp add --transport http bundle https://app.bundle.direct/mcp Then run /mcp in Claude Code and pick bundle to sign in.
Cursor
Add this to ~/.cursor/mcp.json, or to .cursor/mcp.json in a project. Cursor asks you to sign in
the first time it uses Bundle.
{
"mcpServers": {
"bundle": { "url": "https://app.bundle.direct/mcp" }
}
} ChatGPT
Add a custom connector in ChatGPT's settings with the URL above and OAuth as the sign-in method. On some plans you have to turn on developer mode before custom connectors show up.
Other apps
Any app that supports remote MCP servers can use the URL above.
Apps that only run local (stdio) MCP servers can reach Bundle through mcp-remote, which needs Node.js. Run
npx mcp-remote https://app.bundle.direct/mcp, or add it to the app's config:
{
"mcpServers": {
"bundle": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://app.bundle.direct/mcp"]
}
}
} Permissions
When you connect, Bundle asks what the app may do. Reading is on by default. Anything that writes stays off unless you turn it on.
| Permission | What it allows | Default |
|---|---|---|
chat:read | Read the channels, DMs and threads you can see | On |
chat:write | Post messages as you | Off |
docs:read | Read pages and databases you can open | On |
docs:write | Create pages and database rows | Off |
calendar:read | See your calendar events | On |
calendar:write | Create events | Off |
mail:read | Search and read your mail and the shared mailboxes you're in | On |
mail:draft | Write mail drafts for you to review and send | Off |
mail:send | Send mail as you (its own switch under Mail) | Off |
people:read | See the people in the workspace | On |
Guests in a workspace have no mail permissions, because guests don't have Bundle Mail.
Tools
The app can only use the tools covered by the permissions you allowed.
| Tool | What it does | Permission |
|---|---|---|
bundle_search | Search messages, pages and mail | Any read permission |
bundle_list_channels | List the channels and DMs you can see | chat:read |
bundle_read_channel | Read recent messages in a channel or DM | chat:read |
bundle_read_thread | Read a thread | chat:read |
bundle_send_message | Post a message as you, in a channel, DM or thread | chat:write |
bundle_fetch_page | Read a page or database as Markdown | docs:read |
bundle_query_database | Read rows from a database | docs:read |
bundle_create_page | Create a page from Markdown | docs:write |
bundle_create_database_row | Add a row to a database | docs:write |
bundle_list_events | List calendar events | calendar:read |
bundle_create_event | Create an event, with a video call if you want one | calendar:write |
bundle_search_mail | Search your mail, including shared mailboxes you're in | mail:read |
bundle_read_mail_thread | Read a mail thread without marking it read | mail:read |
bundle_create_mail_draft | Write a draft. It isn't sent; you send it yourself from Bundle Mail → Drafts | mail:draft |
bundle_send_mail | Send an email or a reply as you, only when you ask it to send | mail:send |
bundle_send_mail_draft | Send one of your drafts as it is | mail:send |
bundle_list_people | Find people in the workspace | people:read |
bundle_whoami | Show who you're connected as, the workspace and the permissions | None |
Privacy
- The app acts as you. It sees only what you can see in Bundle, and only in the workspace you picked. Private channels, DMs, pages and mailboxes you aren't in stay hidden from it.
- The app can't send mail unless you turn on Send mail as you. Without it, it can only leave drafts for you to review and send. Apps connected before this switch existed have to be connected again to get it.
- Everything the app writes is recorded in the workspace's audit log.
- Each connection is rate limited.
- What the app reads goes to the company that makes it, under that company's terms. Bundle stores the app's access tokens only as hashes. More on how Bundle protects data is on the Security page.
Revoking access
In Bundle, go to Settings → Account & sign-in → Connected AI apps and click Revoke next to the app. It stops working with Bundle right away.
Removing the connector in the AI app doesn't revoke its access in Bundle, so revoke it in Bundle too.
For workspace admins
Owners and admins can turn AI connectors off for the whole workspace in Workspace settings → Features & apps. While the switch is off, every connection in the workspace stops working. Existing connections are paused, not deleted, and work again when you turn the switch back on.