How to Connect Your Gmail Shared Inbox to Claude (MCP Setup Guide)

Nick Timms
Nick Timms, Co-founder
August 8, 2026·8 min read·verifiedReviewed by Duda Bardavid

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:

Claude · connected to Drag + Stripe
Y

Morning. What's waiting on the Support board?

Claude logo
list_threads

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.

Y

Draft replies to the first two in our tone, assign the API one to Marcus, and label everything.

Claude logo
search_knowledgereply_to_threadmove_threadadd_label_to_thread

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.

Y

For Maya's refund, check Stripe for her last payment and put the exact amount in the draft.

Claude logo
Stripe list_paymentsreply_to_thread

Found it: $49.00 on July 28. Draft updated to confirm a $49.00 refund, arriving in 3 to 5 business days.

Y

And how did we do last week?

Claude logo
get_avg_response_time

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):

  1. Open Settings.
  2. Go to Connectors.
  3. Click Add custom connector.
  4. 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:

Claude logoClaude
List the boards in my DragApp.

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

Claude logoClaude
Show me all unread threads on the Support board and summarize the top 5 by urgency.

Reply and act

Claude logoClaude
Draft a reply to the latest thread from [customer] using a warm, concise tone, then assign it to [teammate].

Report

Claude logoClaude
What is our average first response time this week vs last week?

WhatsApp

Claude logoClaude
Check Maria's WhatsApp conversation and send the refund-confirmation template with today's date.

Knowledge

Claude logoClaude
Search our knowledge base for the cancellation policy and draft a reply citing it.

Cross-system (with another connector added, e.g. Stripe or Linear)

Claude logoClaude
Read the latest billing complaint, look up the customer in Stripe, and draft a reply with the correct refund.

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.

Start free trial
ChromeWebDesktopMobileAPIMCP

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):

Email8

list_threads · get_thread · reply_to_thread · send_new_email · search_threads · filter_threads · move_thread · move_threads_bulk

Cards6

list_cards_in_column · get_card · create_card · update_card · move_card · archive_card

Boards5

list_boards · get_board · list_columns · list_board_members · list_teams

Knowledge Base5

list_articles · get_article · create_article · update_article · search_knowledge

Analytics4

get_response_times · get_avg_response_time · get_daily_activity · get_closed_activity

Labels4

list_labels · add_label_to_thread · remove_label_from_thread · toggle_labels

WhatsApp4

get_whatsapp_conversation · list_whatsapp_templates · send_whatsapp_message · send_whatsapp_template

Automations3

list_automations · toggle_automation · toggle_ai_drafts

Contacts3

search_contacts · get_contact_conversations · create_contact

Comments2

add_comment · get_comment

Tags2

list_tags · add_tag_to_card

Tasks1

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/mcp with 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_KEY field, 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.

Nick Timms

Nick Timms

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.

AI Platform

The inbox your team and your AI work in together

Shared inbox, boards, live chat, and WhatsApp with AI included, in Gmail and beyond, plus an MCP server your AI tools can drive.

7-day trial, no card required4.7 · 1,200+ reviews
Gmail extension
Web app
Desktop
iOS + Android
API
MCP server: works with Claude, ChatGPT, Copilot, Cursor