Explore

Superhuman Mail MCP Server Overview

This document is intended for admins evaluating the Superhuman Mail MCP Server for their organization. Contact your CSM to enable access for your org or select users.

What is it?

The Superhuman Mail MCP Server is an official, first-party integration that lets users drive Superhuman Mail directly from AI tools like Claude and ChatGPT. Once connected, users can search emails, draft and send replies, manage their calendar, and chain Superhuman with other MCP-connected tools — all without leaving their AI tool.

⁠

Plan Availability

Enterprise admins can opt in via their CSM. Admins can also enable access for a subset of users rather than the whole domain.

⁠

Supported AI Clients

The MCP server works with any MCP-compatible client. Prioritized clients include:

Claude (Desktop, Code, and

claude.ai⁠

)

ChatGPT

Any MCP-compatible client via standard protocol

One-click setup is available via the Claude Connector Directory and ChatGPT App Store. Other clients can connect using the server URL and OAuth authentication.

More instructions here.⁠

⁠

Admin Controls

What admins can control:

Enable or disable MCP access for the entire team or specific users (via CSM)

Users can run the MCP server in read-only mode to block send/write actions

Tool access for the org (e.g. read-only) for the official Claude connector only

Not yet available:

Restricting access to specific AI clients (e.g., allow Claude, block ChatGPT)

Self-serve admin controls

Scoped permissions per tool (e.g., allow search but block send) — this happens on the user level

Full observability and audit tracing of MCP tool calls

⁠

What Users Can Do

These capabilities are powered by the following MCP tools:

query_email_and_calendar — Use natural language (semantic search) to ask a question about your email and calendar

create_or_update_draft — Create or edit an email draft, using your voice and tone. Drafts created by the MCP Server will appear in Superhuman Mail.

list_email — Search for and return emails matching specific criteria (To, From, Subject, date)

send_email — Send an email (From, To, Cc, Bcc, Subject, HTML body). We strongly advise enabling the option to request confirmation each time in your AI assistant, as it can send emails instantly without delay. Smart Send is an optional parameter that sends at the most likely time the recipient(s) will open it.

get_email_thread — Fetch and display a full email thread’s contents

update_email — Add/remove Labels, add/remove Reminders, Star/Unstar, Trash, mark Done, mark Read/Unread for email thread(s) — Gmail accounts only

get_read_statuses — Read the read/unread status for emails that meet specific criteria (time-based, etc.)

create_or_update_event — Create and update calendar events

get_availability_calendar — Find available meeting times for a group of participants

update_preferences_email_and_calendar — Update writing style, event creation preferences, and facts used to draft emails and calendar events. Updates are made to Superhuman’s Personalization settings.

⁠

Send Controls

Users can send email via MCP, not just draft. However:

Every tool invocation requires explicit user approval — the user must confirm each action in their AI client

Users can run in read-only mode to disable send/write capabilities entirely; or, with the official Claude connector, admins can enforce read-only mode in Claude admin settings

Drafts created via MCP appear in the user’s Superhuman drafts folder for review before sending

⁠

Data Flow & Privacy

The Superhuman Mail MCP Server is a remote server hosted by Superhuman. When a user asks their AI tool a question, the AI client calls the Superhuman MCP server, which returns structured data (email content, search results, calendar info). That data is then sent to the AI provider for reasoning.

This means: Email content returned by the MCP server is processed by the AI provider (Anthropic for Claude, OpenAI for ChatGPT). This is inherent to the MCP architecture.

Key distinction: Superhuman’s Zero Day Data Retention and no-model-training commitments apply to Superhuman’s built-in AI features (Ask AI, Smart Compose, Auto Labels), where Superhuman controls the subprocessor relationship.

Data sent to external AI providers via MCP is governed by that provider’s data handling policies, which can depend on agreements you have with that company (e.g. OpenAI, Anthropic). MCP connections are user-initiated, and each tool invocation requires explicit user approval.

⁠

Access & Permissions

Users can only access the mailbox(es) they are authenticated into through Superhuman. The MCP server operates under the authenticated user’s existing identity and permissions — no elevated access is granted.

The server works with both Gmail and Outlook accounts connected to Superhuman, and is subject to Gmail and Outlook API rate limits.

⁠

Audit & Observability

Not yet available. MCP actions are not separately logged today — there are no unique identifiers distinguishing MCP-initiated actions from direct user actions. If this is a requirement for your organization, let your CSM know.

⁠

Getting Started

Contact your CSM to enable MCP access for your team (or a subset of users)

Users connect with the server URL and OAuth

One-click connectors coming soon

Optional: Instruct users to use read-only mode if your org wants to restrict send capabilities during evaluation

For setup instructions, see the

Superhuman Mail MCP Server Help Article⁠

⁠

Questions?

Reach out to your Customer Success Manager or email

hello@superhuman.com⁠

Want to print your doc?
This is not the way.

Try clicking the ··· in the right corner or using a keyboard shortcut (

CtrlP

) instead.