Superhuman Mail MCP Server

Prerequisite: You must have Claude Code installed on your device.

1. Hit Cmd+Space → Terminal to open Terminal.

2. In Terminal, type or paste the following command:

   claude mcp add --transport http superhuman-mail https://mcp.mail.superhuman.com/mcp

3. Hit Enter.

4. In Terminal, type the following command to start Claude Code:

   claude

5. Hit Enter.
6. Type /mcp and hit Enter.
7. Hit the down arrow to select superhuman-mail and hit Enter.
8. Hit the down arrow to select Authenticate and hit Enter.
9. Complete the OAuth sign-in flow in your browser.

Once authenticated, your AI tool can access your Mail inbox and calendar.

💡 Tip: You can rename superhuman-mail to anything you prefer when adding the MCP server.

Prerequisite: You must have Claude Code installed on your device.

1. Hit Win+R to open the "Run dialog" box.
2. Type cmd and hit Enter to open Command Prompt (or search for PowerShell in the Start menu).

3. In the terminal, type or paste the following command:

   claude mcp add --transport http superhuman-mail https://mcp.mail.superhuman.com/mcp

4. Hit Enter.

5. In Terminal, type the following command to start Claude Code:

   claude

6. Hit Enter.
7. Type /mcp and hit Enter.
8. Hit the down arrow to select superhuman-mail and hit Enter.
9. Hit the down arrow to select Authenticate and hit Enter.
10. Complete the OAuth sign-in flow in your browser.

1. Go to claude.ai/directory/connectors/superhuman-mail. Or, in Claude Desktop, open Settings → Connectors → Browse Connectors and search for Superhuman Mail.
2. Click Add or Install.
3. Sign in with your Superhuman Mail account to grant Claude permission to access your email.
4. Start using Superhuman Mail tools in your conversations.

💡 Tip: Installing the app on Desktop also enables Mail on iOS and Android — no extra setup needed.

1. On Desktop, open the Superhuman Mail app in the ChatGPT app directory. Or, go to Settings → Personalization → Apps → Add More and search for “Superhuman Mail.”
2. Click Connect, Add, or Install.
3. Sign in with your Mail account to give ChatGPT access to your email.
4. Start using Mail tools in your conversations.

💡 Tip: Installing on Desktop also enables Mail in the ChatGPT Mobile app — no extra setup needed.

1. Open Settings, then Tools & MCP.
2. Click New MCP Server.

3. Paste the following configuration into the file and save:

   {

     "mcpServers": {

        "superhuman-mail": {

         "url": "https://mcp.mail.superhuman.com/mcp",

         "headers": {}

      }

   }

   }

4. Click Connect.
5. A Mail authentication window will appear in your browser. Complete the authentication process.
6. Once authenticated, you'll be redirected back to Cursor.

The MCP Server is now connected!

Option 1

1. In Cursor, go to Settings, then Integrations & MCP.
2. Click Add MCP.
3. Enter the server URL:
   https://mcp.mail.superhuman.com/mcp
4. Follow the prompts to authenticate.

If the Add MCP option isn't available, use the following steps instead.

Option 2

1. In Cursor, click Automations.
2. Click New Automation.
3. Click Add Tool or MCP.
4. Set the name to superhuman-mail and enter the following URL:
   https://mcp.mail.superhuman.com/mcp
5. Complete the authentication process when prompted.

Note: Currently works with the Gemini CLI only, not the Gemini app.

1. Open the Gemini CLI settings file:
   • Mac: Open Finder, press Cmd+Shift+G, navigate to ~/.gemini/
   • Windows: Open File Explorer, type %USERPROFILE%\.gemini\ in the address bar, press Enter
   • Linux: Open a terminal and navigate to ~/.gemini/
2. Open (or create) settings.json in a text editor.
3. Add:

  "mcpServers": {

     "superhuman-mail": {

      "url": "https://mcp.mail.superhuman.com/mcp"

   }

}

4. Save and restart the Gemini CLI.
5. Type /mcp auth superhuman-mail and hit Enter.
6. Complete authentication in your browser.

Many MCP-compatible clients only need the server URL to connect. If your client isn't listed above, try adding Mail using this configuration:

"superhuman-mail": {

"type": "remote",

"url": "https://mcp.mail.superhuman.com/mcp",

"enabled": true

}

If your client uses a different setup method, you might be able to use the raw server URL: https://mcp.mail.superhuman.com/mcp

Check your client's documentation for the best way to add a remote MCP server.

The MCP Server allows AI tools like Claude and ChatGPT to connect directly to your Superhuman inbox and calendar. This allows AI to search, draft, and send emails or manage events without switching apps.

When you set up the MCP Server, you'll see a Superhuman authentication screen that may look familiar — this is expected. You'll need to authenticate through this screen to give your AI assistant explicit permission to connect to your Superhuman Mail account.

Even though you're already signed in to Superhuman, this additional step is required to authorize the MCP connection.

MCP access will be disabled for Enterprise accounts by default. If you are the admin of an Enterprise team and would like to enable or disable Superhuman AI or the MCP Server for your team, please reach out to your Customer Success Manager at Mail.

It's not possible to disable the MCP Server across an organization that's not on an Enterprise plan. However, customers can always choose not to enable the MCP Server for their accounts.

Yes. Drafts created through MCP appear in your Mail drafts folder. In Mail, hit G then D to access your Drafts folder.

If your AI tool shows a card from the Gmail or Outlook connector (rather than Superhuman Mail), that draft was created outside the Mail MCP Server.

To make sure your AI tool uses Mail, ask your AI assistant explicitly — for example, "Please use Superhuman Mail to draft this."

Yes. The MCP server includes a send_email tool that allows AI agents to send email directly, not just draft them. The individual must approve the use of the tool, and they can choose to use the Mail MCP Server in read-only mode.

Before using this tool, we strongly advise enabling the option to request confirmation each time in your AI assistant, as it can send emails instantly without any delay.

Not yet! Attachment support is coming in a future release, and we'll be sure to update this article once it's available.

There is currently no usage limit for the MCP server. This may change in the future, and if it doesn, we'll update this article.

Yes, send limits are determined by your email provider — Google or Microsoft 365. Since Mail connects to your account through the provider's API, sends through Mail are limited by Google or Microsoft.

Not at this time. When this becomes available, we'll update this article.

Yes! Claude for iOS and Android supports the Mail MCP Server, but you can't add it directly from the Mobile app.

Your AI tool will show which MCP tool it calls when performing an action. Expand the reasoning or thinking section to view the server used.

As of now, there isn't a way to set the Mail MCP Server as the default. However, you can add "Please use Superhuman Mail MCP Server" to your prompt.

Yes. The Mail MCP Server is a remote server hosted by Superhuman Mail — it is not a local-only server. When a user asks their AI tool a question, the AI client calls the MCP Server, which processes the request and returns structured data. That data (e.g., email content, search results, calendar info) is then sent to the AI provider for the model to reason.

This is inherent to the MCP architecture.

Mail's existing data protection commitments — including Zero Day Data Retention agreements with AI subprocessors and the policy that no AI subprocessor may use customer data for model training — apply to Superhuman's built-in AI features, where Superhuman controls the contractual relationship with the underlying AI provider.

MCP introduces a different interaction method. When a user connects Mail to an external AI tool such as Claude or ChatGPT via MCP, email and calendar data returned by the Mail MCP Server is transmitted to the AI provider for processing. In this scenario, the user maintains a direct relationship with the AI provider (Anthropic, OpenAI, etc.), and the data protection terms governing that interaction are the AI provider's own policies — not Superhuman's subprocessor agreements.

In practice, this means:

• Mail's Zero Day Data Retention commitment governs data processed by Mail's own AI infrastructure (e.g., Ask AI, Smart Compose, Auto Labels).
• Data transmitted to external AI providers via MCP is governed by the respective provider's data handling policies.
• Superhuman does not send customer data to external AI providers on its own initiative — MCP connections are user-initiated, and each tool invocation requires explicit user approval.

No specific logging for MCP exists, and there are no unique identifiers that will inform whether an action was taken via MCP or a human user. 

The Superhuman MCP Server doesn't handle scheduling on its own — it's the connection that gives your AI assistant access to your email and calendar. To run Superhuman-powered tasks on a recurring schedule (like a daily inbox summary or a Monday morning briefing), set up the schedule through your AI assistant directly.

• Claude Cowork (desktop, non-developers) — Open Cowork, click + New task, enter your prompt, then type /schedule to set a recurring cadence: hourly, daily, weekly, or weekdays only.
  • ⚠️ Note: Cowork tasks only run while your computer is awake and the Claude Desktop app is open.
• Claude Code cloud tasks (developers) — Cloud-based scheduled tasks run on Anthropic's infrastructure at claude.ai/code/scheduled, even when your computer is off.
• ChatGPT scheduled tasks — Ask ChatGPT directly — e.g., "Give me a briefing every morning at 8 AM." Manage your tasks via your profile icon, then Tasks. ChatGPT allows up to 10 active tasks and requires a Plus, Pro, or Team plan. Tasks run on schedule whether or not you're using the app.

Yes — paste the Superhuman Mail skills library into your AI assistant’s chat to get started. Or, download the .md files from the same library and add them to your AI assistant. For Claude, go to Customize → Skills → Add Skills. For ChatGPT on web, go to Skills → New Skill → Upload from your computer.

Point it to the JSON version of this article — it's optimized for machine reading.

Your network settings need to allow it. In Claude Desktop, open Settings and:

1. Turn on Allow network egress.
2. Set Allowed domains to All domains.

Without these settings, Claude Desktop can't download files from external sources.

By default, your AI assistant asks you to confirm every action the Superhuman Mail MCP Server takes — reading emails, creating drafts, sending messages, and so on. It's a safety net, not a permanent setting. Admins and individual users can update these permissions to cut down on prompts.

Claude

Admins: go to Organization settings → Connectors → Superhuman Mail → click … → See Details. Then click the icon next to each tool to set it to Always Allow or Needs approval.

Users (with the right permissions): go to Settings → Connectors → Superhuman Mail → Configure. Then click the icon next to each tool to set it to Always Allow or Needs approval.

💡 Tip: Keep send_draft on Needs approval so a message never goes out without your sign-off.

ChatGPT

Admins: go to Workspace settings → Apps → Superhuman Mail → click … → Action consent → Allow read actions with no user confirmation. From there, anyone in your workspace can run read actions without confirming each one.

Note that Write actions — drafting, sending, or deleting — still require confirmation. There's no way to change that today.

If you haven't already, make sure you have the Superhuman Mail web app installed in Google Chrome. Once you've installed the web app, try again.

It might also help to make sure Google Chrome is allowed to open the Mail app.

Claude Desktop requires a tool called Node.js to run the Superhuman Mail connection. This is a one-time setup:

1. Hit Cmd+Space → Terminal to open Terminal.
2. In Terminal, type or paste the following command:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. Hit Enter.
4. Terminal will ask for your Mac login password. When you type it, nothing will appear on screen. This is completely normal. Just type your password carefully and hit Enter.
5. Installation may take a few minutes. Pay attention to Homebrew's instructions for next steps. You'll likely need to run three individual commands in your terminal to add Homebrew to your PATH.
6. Wait until you see the regular prompt again, ending with % or $. Then install Node.js by pasting the following command:

brew install node

7. Hit Enter.
8. Verify everything is installed correctly by pasting the following command:

npx --version

9. Hit Enter.
10. If you see a version number like 10.8.2, you're good to move on. If it says command not found, try closing and reopening Terminal, then run npx --version again.

This error means the MCP Server is running on an older version of Node.js, v18 or earlier, but it requires v20.18.1 or higher. This can happen if you have multiple Node.js versions installed and your system is defaulting to the wrong one.

Step 1: Find your Node 20 path

1. Hit Cmd+Space → Terminal to open Terminal.
2. In Terminal, type or paste the following command:

nvm which 20

3. Hit Enter.

This should print a path like /Users/yourname/.nvm/versions/node/v20.x.x/bin/node. Copy everything up to and including /bin/ — you'll need it in the next step.

If this command says N/A or fails, install Node 20 first:

nvm install 20

Then run nvm which 20 again.

Step 2: Update your Claude Desktop config

1. Open the claude_desktop_config.json file using the steps outlined in the Claude Desktop section of this article.
2. Find the "Superhuman Mail" entry point and update it to match the format below, replacing the example path with the one you copied in Step 1.

"Superhuman Mail": {
  "command": "/Users/yourname/.nvm/versions/node/v20.x.x/bin/npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://mcp.mail.superhuman.com/mcp"
  ],
  "env": {
    "PATH": "/Users/yourname/.nvm/versions/node/v20.x.x/bin:/usr/local/bin:/usr/bin:/bin"
  }
}

3. Save the file.

Step 3: Clear the npm cache

1. Hit Cmd+Space → Terminal to open Terminal.
2. In Terminal, type or paste the following command:

rm -rf ~/.npm/_npx

3. Hit Enter.

Step 4: Restart Claude Desktop

1. Fully quit and reopen Claude Desktop.
2. The MCP Server should now connect successfully.

Windows users: The steps are the same, with a few differences:

• To find your Node 20 path, run nvm which 20 in Command Prompt.
• Open Command Prompt by hitting Win+R, typing cmd, and hitting Enter.
• The path will look like C:\Users\yourname\AppData\Roaming\nvm\v20.x.x.
• When updating your config, set "command" to that path followed by npx.cmd, and update the new "PATH" to use that same folder with semicolons instead of colons.
• To clear the npm cache, run rmdir /s /q %LOCALAPPDATA%\npm-cache_npx.

This error occurs when a local MCP connector is configured (via a .json file), which is no longer compatible with recent updates to the Claude connector. The fix is quick — go to Settings → Developer → Local MCP Servers, and delete the local connector by clicking Trash next to it in Claude Desktop. Click Edit Config to ensure the Superhuman Mail local MCP server is removed completely in your .json configuration file.

Once the local connector is removed, follow the instructions above to set up the Superhuman Mail MCP as a custom (remote) connector.

The good news? Once you switch over, you'll get access to a more polished connector experience with some great UI improvements we've been working on.