How to Connect Your Gmail Shared Inbox to Claude (MCP Setup Guide)
Claude can run your Gmail shared inbox through one custom connector. The three-step setup with screenshots, what to ask once connected, and the config-file route for Cursor and ChatGPT.
- Connect Claude to your shared inbox in three steps: add https://app.dragapp.com/mcp as a custom connector in Claude's settings, click Connect, and enter your Drag API key on the secure connect page. Ask Claude to list your boards to confirm.
- Setup takes about five minutes with nothing to install and no code, and it works on every Claude plan, including Free.
- Your key is entered once on the connect page, never in a web address, and the connect service stores nothing. Claude asks your permission before using each tool.
- Once connected, Claude has 47 tools across 12 categories, and connectors stack: add Stripe's alongside Drag's and Claude can check a payment, then drop the amount into a reply draft, in one chat.
Table of contents
Connect Claude to your Gmail shared inbox and the queue becomes something you can talk to: show me today's unread threads, draft replies to the urgent ones, assign the rest. The setup is three steps, takes about five minutes, and needs nothing installed and no code.
Under 30 seconds, if you have done this before: Claude › Settings › Connectors › Add custom connector › paste https://app.dragapp.com/mcp › Connect › enter your Drag API key (DragApp › Settings › Integrations) on the page that opens. Done.
This is what it buys you. One connected chat, working a real morning queue:
Morning. What's waiting on the Support board?
7 unread. Three need you first:
1. "Order #4821 - shipping damage" · Sarah Mitchell URGENT
2. "Refund not received" · Maya Torres BILLING
3. "API rate limit increase" · DevOps Team ENGINEERING
The other four are newsletter replies and can wait.
Draft replies to the first two in our tone, assign the API one to Marcus, and label everything.
Two drafts ready for your review, written against your help center's shipping-damage and refund articles. The API thread is assigned to Marcus and labeled Engineering.
For Maya's refund, check Stripe for her last payment and put the exact amount in the draft.
Found it: $49.00 on July 28. Draft updated to confirm a $49.00 refund, arriving in 3 to 5 business days.
And how did we do last week?
Average first reply 2h 14m, 18% faster than the week before. Tuesday was the slow day.
One chat, two connectors: Drag for the inbox, Stripe for payments. Claude asked permission the first time it used each tool.
The Stripe step works because connectors stack: add Stripe's connector alongside Drag's and Claude uses both in the same conversation. The rest of this guide gets you to that point.
Before you start
Three terms cover all the theory. MCP (Model Context Protocol) is the standard that lets AI tools plug into other software, and Drag runs an MCP server for your inbox. A custom connector is Claude's name for plugging into one: you give Claude a web address, and everything behind it becomes tools Claude can use, with your permission. Your Drag API key is the code that proves the connection is yours, which is why Claude can only ever see what your Drag account can see. Deeper background, if you want it: MCP for customer support.
You need two accounts:
A Claude account, on any plan including Free (which allows one custom connector). On Team and Enterprise plans, an Owner enables connectors for the organization first.
A DragApp account with your shared inbox set up, on a plan with API access.
Connecting from Cursor, Claude Code, or Windsurf instead? Jump to the config-file setup.
How to connect Claude to your shared inbox
Step 1: Add the connector in Claude
In Claude (web or desktop app):
- Open Settings.
- Go to Connectors.
- Click Add custom connector.
- Paste this URL and click Add:
https://app.dragapp.com/mcp
Step 2: Click Connect
Drag now appears in your connector list. Click Connect. A Drag connect page opens in your browser and asks for one thing: your API key.
Step 3: Enter your Drag API key
In DragApp, open Settings, then Integrations, and copy your API key. Paste it into the connect page and submit.
Drag verifies the key and the connection goes live. The key is entered once, on that page only: it never appears in a web address, and the connect service stores nothing on its own servers. Treat it like a password everywhere else. If it ever leaks, generate a new one from the same Drag screen, which instantly cuts off the old one, and removing the connector in Claude ends the connection just as fast.
You're connected: what to ask first
Back in Claude, start a chat and confirm it worked:
The first time Claude uses a Drag tool, it asks your permission, for that tool specifically: allow once, allow always, or refuse. Approve it, and your boards appear in the answer. That is the whole setup; if a step failed instead, troubleshooting below covers the usual three: a mistyped URL, a workspace where an Owner has not enabled connectors yet, or a key with a stray space in it.
From here, ask for real work. One prompt per job, copy-ready, each mapping to real tools:
Triage
Reply and act
Report
Knowledge
Cross-system (with another connector added, e.g. Stripe or Linear)
For full working days run this way, morning triage to end-of-week reporting, see running support inside Claude or ChatGPT.
AI Platform
The inbox your team and your AI work in together
Shared inbox, live chat, and AI in Gmail, with an MCP server your AI tools can drive.
What you can do once connected: 47 tools across 12 categories
The prompts above barely scratch it. Claude has 47 tools for your inbox, across email (8), WhatsApp (4), boards (5), cards (6), labels (4), contacts (3), knowledge base (5), analytics (4), automations (3), comments (2), tags (2), and tasks (1):
list_threads · get_thread · reply_to_thread · send_new_email · search_threads · filter_threads · move_thread · move_threads_bulk
list_cards_in_column · get_card · create_card · update_card · move_card · archive_card
list_boards · get_board · list_columns · list_board_members · list_teams
list_articles · get_article · create_article · update_article · search_knowledge
get_response_times · get_avg_response_time · get_daily_activity · get_closed_activity
list_labels · add_label_to_thread · remove_label_from_thread · toggle_labels
get_whatsapp_conversation · list_whatsapp_templates · send_whatsapp_message · send_whatsapp_template
list_automations · toggle_automation · toggle_ai_drafts
search_contacts · get_contact_conversations · create_contact
add_comment · get_comment
list_tags · add_tag_to_card
create_task
The full tool-by-tool reference is in the Drag MCP docs.


Connecting from Cursor, Claude Code, or Windsurf
These tools run the same server locally from a config file: same key, same 47 tools, a slightly more technical door. You need Node.js installed (the free LTS from nodejs.org) and your API key from DragApp under Settings and Integrations.
Claude Code is one terminal command:
claude mcp add dragapp -e DRAG_API_KEY="your-api-key" -- npx -y @dragapp/mcp-server
Cursor and Windsurf take one config block. The generator writes it for you: paste your key, pick your tool, copy the result into the file it names (.cursor/mcp.json for Cursor, ~/.codeium/windsurf/mcp_config.json for Windsurf).
The underlying config is always this shape, whichever tool it goes into:
{
"mcpServers": {
"dragapp": {
"command": "npx",
"args": ["-y", "@dragapp/mcp-server"],
"env": {
"DRAG_API_KEY": "your-api-key"
}
}
}
}
(Claude Desktop can use this too, in claude_desktop_config.json, though the connector route above is simpler there.) Then fully quit and reopen the tool (locally-run servers load at startup) and verify the same way: ask it to list the boards in your DragApp.


Connecting from ChatGPT and other URL-based tools
The same URL works in any AI tool that accepts remote MCP connectors. ChatGPT accepts them in its connector settings on the Business, Enterprise, Pro, and Team plans: add https://app.dragapp.com/mcp there and enter your key on the connect page, the same shape as Claude's four steps. This is the hosted connection this guide used to describe as "coming next"; it shipped in August 2026, and we will publish per-tool walkthroughs as we verify each tool's exact click path.
Troubleshooting
- The connector won't add. Check the address is exactly
https://app.dragapp.com/mcpwith nothing extra. On Team and Enterprise plans, an Owner has to enable custom connectors in organization settings first; if the option is missing from your settings, that is why. - The key is rejected on the connect page. Re-copy it from Drag under Settings, then Integrations (watch for a stray space at either end), and confirm your Drag plan includes API access.
- Claude connects but won't act. A tool you refused stays refused until you change it in the connector's permission settings.
- Config-file route: the tools never appear. Fully quit and restart the tool, not just the window. Locally-run servers load at startup, and a missing restart is the most common failure.
- Config-file route: "npx: command not found." Node.js is missing or not on your PATH. Install the LTS from nodejs.org and restart.
- Config-file route: authentication fails. Re-copy the key into the
DRAG_API_KEYfield, no extra spaces. A stray comma in hand-edited JSON fails silently too; use the generator.
Wherever you enter it, the key grants full access to your workspace: never commit it to a repo or paste it anywhere except the connect page or your own config file, and rotate it in Drag's settings if it is ever exposed.
For a broader look at shared inbox tools, including which ones have MCP servers at all, see the best shared inbox software guide.
Frequently asked questions
Do I need to be technical to set this up?
No. The Claude setup is pasting a web address, clicking Connect, and entering a key on a form; nothing is installed and no file is edited. The config-file route for Cursor and Claude Code is slightly more hands-on, but it is one copy-pasted block, and the generator on this page writes it for you.
Is the connection secure, and what can Claude see?
The connection inherits your Drag permissions, so Claude can only see and do what your account can. Your key is entered once on the secure connect page, never in a web address, and the connect service stores nothing. Claude asks permission per tool, and removing the connector or rotating the key ends access instantly.
Which AI tools work with Drag's MCP server?
Claude connects through the four-step connector setup, and so can any tool that accepts remote MCP connectors, including ChatGPT on its business plans. Cursor, Windsurf, and Claude Code connect through a config file instead. Either door reaches the same server and the same 47 tools.
Does the older config-file setup still work?
Yes. The npm package (@dragapp/mcp-server) works exactly as before and remains the right route for config-file tools like Cursor and Claude Code. The hosted connection shipped in August 2026 and added the faster paste-a-URL door for Claude and ChatGPT; nothing about existing setups needs migrating.
Can I use this with ChatGPT instead of Claude?
Yes. ChatGPT accepts remote MCP connectors on its Business, Enterprise, Pro, and Team plans: add the same URL in its connector settings and enter your key on the connect page. The free ChatGPT plan does not currently accept custom MCP connectors, so free-plan users need one of the config-file tools instead.
How many tools does the Drag MCP server have?
47 tools across 12 categories: email, WhatsApp, boards, cards, labels, comments, tags, tasks, contacts, knowledge base, analytics, and automations. The tool-by-tool reference, with every name and what it does, lives in the Drag MCP docs.
Co-founder
Building Drag for nearly ten years: shared inboxes, boards, and now the AI and agent layer, all on Gmail, plus HeyHelp for the personal inbox. Writes the honest versions of the comparisons.
