Skip to main content
Glama
mailmcp

mailmcp

mailmcp is a self-hosted MCP server that gives ChatGPT, Claude and other MCP clients access to your e-mail over IMAP and SMTP: several mailboxes at once, any provider, attachments in both directions. This repository is the prebuilt distribution (minified bundles in dist/, no build step) under a commercial licence; it runs as a free tier without a key. The source code is not provided.

Ask "What came in from accounting this week?" and get one answer across Gmail, iCloud and the company mail server: the invoice as a download link, a reply already drafted.

When to use it

Use mailmcp when you have more than one mailbox, a provider without an official connector, or you need attachments. As of September 2026 the official Gmail and Outlook connectors in ChatGPT and Claude handle one mailbox each and cannot send attachments.

Official connectors

mailmcp

Mailboxes

one per connector

several at once, one token

Providers

Gmail, Outlook

Gmail, Outlook.com, Microsoft 365, iCloud, Fastmail, Yahoo, Zoho, Seznam.cz and any IMAP/SMTP server with password sign-in, including your own domain

Attachments

read some, send none

one-hour download links; sending from the mailbox, from a file the assistant uploads, or by forwarding

Authentication

OAuth grant held by the AI vendor

an app password, encrypted in your browser into a token; the server keeps one master key and no database

Hosting

the vendor's

yours: Vercel, Docker, any Node 22 host, or Claude Desktop without a server

Cost

included in the assistant's plan

free with a signature in sent mail, or one payment (€19 / €149)

Related MCP server: IMAP MCP Connector

Quickstart

Requirements. Node 22 (or Vercel, or Docker), an HTTPS address (ChatGPT and Claude only connect over HTTPS), and an app password for each mailbox. Gmail: turn on 2-Step Verification first, otherwise Google hides the app-passwords page (organisation policies or Advanced Protection can hide it too). Outlook.com and Microsoft 365 need no password: the user signs in at Microsoft on the setup page (see "Outlook and Microsoft 365" below).

  1. Set an invite code. A server that issues user tokens must say who may create one, otherwise anyone who knows the address can spend your quota. Pick MAILMCP_INVITE_CODE (at least 8 characters) and hand it to the people who may create a token; without it the server issues no tokens and the setup page shows a notice for you. Forgot the code? Read it in your Vercel or Docker environment, or set a new one and redeploy: tokens already issued keep working. A deliberately public server sets MAILMCP_OPEN_SIGNUP=1 instead.

  2. Deploy. Click the Vercel button above; it asks for MAILMCP_KEY (32 random bytes as base64url, node -e "console.log(require('crypto').randomBytes(32).toString('base64url'))"), MAILMCP_LICENSE (your key, or empty for the free tier) and the invite code from step 1. Or run it yourself:

    docker build -t mailmcp . && docker run -d -p 8080:8080 \
      -e MAILMCP_KEY=… -e MAILMCP_LICENSE=… -e MAILMCP_INVITE_CODE=… \
      -e MAILMCP_PUBLIC_URL=https://mail.example.com mailmcp
    # without Docker: node dist/node.js with the same variables
  3. Open https://<your-server>/start and follow it: on the setup page pick the provider, paste the e-mail and the app password, tick what the assistant may do (reading is on by default; drafts are a good second step; sending only with an allowlist of recipients). The page encrypts the password in your browser and hands you one token.

  4. Connect. ChatGPT → Settings → Apps → Create → URL https://<your-server>/mcp; claude.ai → Settings → Connectors → Add custom connector. Sign in with the token. Then ask: "List my mail accounts."

Try it without deploying. The shared server at mailmcp.ai/setup runs this same code; create a token there and connect. The operator of any shared server can technically see your configuration while it serves your requests, which is why companies run their own.

Claude Desktop, no server. Download mailmcp.mcpb from the latest release, open it in Claude Desktop, paste the configuration from /setup → "Values for your own deployment".

Behind a reverse proxy set MAILMCP_PUBLIC_URL or MAILMCP_TRUST_PROXY=1. Company mail servers on private addresses need MAILMCP_ALLOW_PRIVATE_MAIL_HOSTS=1. Changing MAILMCP_KEY invalidates every token. All variables: .env.example.

Variable

What it does

MAILMCP_KEY

The one master key; seals user tokens and signs OAuth artifacts. Changing it invalidates every token.

MAILMCP_LICENSE

Your licence key. Empty runs the free tier.

MAILMCP_INVITE_CODE

Required on a token-issuing server: the code your users type on /setup, at least 8 characters.

MAILMCP_OPEN_SIGNUP

1 on a deliberately public server, in place of an invite code.

MAILMCP_MS_CLIENT_ID

Your own Entra app registration id for the Microsoft sign-in. Required for any Microsoft sign-in on your server (the vendor's app is used on mailmcp.ai only).

MAILMCP_MS_REDIRECT

1 when this origin is registered as a redirect URI (https://<host>/api/ms/callback) in that app: the setup page then signs in through a popup instead of a device code.

MAILMCP_MS_DISABLED

1 hides the Microsoft sign-in and answers 404 on every /api/ms/* route.

MAILMCP_DISABLE_GRAPH

1 refuses Outlook mailboxes at runtime, including in tokens already issued.

MAILMCP_ATTACHMENT_DIRS

stdio only: folders (separated by : on macOS/Linux, ; on Windows) where attachments may be saved and read, in addition to policy.attachment_dirs. Claude Desktop sets them in the extension settings.

MAILMCP_NO_STATS

1 switches the usage statistics off; the daily update check stays (a GET /api/version without content).

MAILMCP_STATS

Server copies: 0/false/off/no switches the statistics off, like MAILMCP_NO_STATS=1. Claude Desktop and other desktop (stdio) copies: 1/true/on/yes switches them on (the extension setting "Anonymous usage statistics" writes it); empty or unset leaves them off.

MAILMCP_NO_UPDATE_CHECK

1 sends no request to mailmcp.ai at all: no update check and no statistics.

DO_NOT_TRACK

1/true switches the statistics off, like MAILMCP_NO_STATS=1.

MAILMCP_PUBLIC_URL

The public address, when the server is behind your own reverse proxy.

MAILMCP_ALLOW_PRIVATE_MAIL_HOSTS

1 lets user tokens name mail servers on private addresses.

Outlook and Microsoft 365

These mailboxes have no password: Microsoft rejects password sign-in on most accounts. The user picks the provider Outlook / Microsoft 365 on /setup and clicks Sign in with Microsoft. This needs your own Entra app registration (MAILMCP_MS_CLIENT_ID, steps below); without it the setup page offers no Microsoft sign-in. When your server's origin is a registered redirect URI (MAILMCP_MS_REDIRECT=1) the button opens a popup with the account picker; otherwise the page asks whether the user signs in with a personal account (Outlook.com, Hotmail) or a work or school account (Microsoft 365) and shows a short code to type at microsoft.com/link or login.microsoft.com/device respectively. Either way the sign-in sits behind your invite code (the device-code relay requires one even with MAILMCP_OPEN_SIGNUP=1), and your users see your app's name on the consent screen. No token reaches the vendor: your server runs the sign-in.

What to tell your users: at most three Outlook mailboxes per token; the consented Microsoft permissions follow the capabilities they tick (Mail.Read for read-only, otherwise Mail.ReadWrite and Mail.Send), so widening them later needs a new sign-in; a sign-in lasts about 90 days (the date is on /setup and in list_accounts as reauth_by, and clients that refresh through our OAuth have it rolled automatically); changing the mailbox password does not end it, revoking the app at Microsoft does, for every token that used that account. Tenants that leave consent to administrators need a one-off approval at https://login.microsoftonline.com/organizations/adminconsent?client_id=<your client id>. Mail then flows over Microsoft Graph, so message ids are strings rather than numbers and labels are Outlook categories. Full guide: mailmcp.ai/docs.

Your own Microsoft app registration

Microsoft sign-in on your server needs an app registration of your own (the vendor's registration is used on mailmcp.ai only). Register it and use the popup flow, which works for personal and work accounts alike; new Microsoft 365 tenants block sign-in with a code (security defaults, AADSTS530035):

  1. Microsoft Entra → App registrations → New registration; supported account types: Accounts in any organizational directory and personal Microsoft accounts.

  2. Authentication → add the platform Mobile and desktop applications (not Web) with the redirect URI https://<your host>/api/ms/callback. mailmcp is a public client with no secret; under the Web platform Microsoft demands one and the sign-in fails with AADSTS7000218.

  3. Authentication → Allow public client flows: Yes.

  4. API permissions → delegated Microsoft Graph Mail.Read, Mail.ReadWrite, Mail.Send, User.Read, offline_access.

  5. Set MAILMCP_MS_CLIENT_ID=<Application (client) ID> and MAILMCP_MS_REDIRECT=1, redeploy.

Tenants that allow user consent only for verified publishers additionally need publisher verification on your registration (Microsoft AI Cloud Partner Program), or an admin's consent for the whole tenant.

What the assistant can do

Every tool is gated by the permissions in the token, per mailbox:

Permission

Tools

read (default)

list_accounts, list_folders, search_messages (Gmail syntax on Gmail), get_message, get_thread, get_attachment (one-hour download link), ChatGPT search/fetch, triage, awaiting_replies, digest, list_followups, list_templates, unsubscribe (dry run; sending the one-click request needs the separate unsubscribe permission, off by default)

draft

create_draft, reply_draft, save_template, set_signature, upload_attachment, request_upload (a one-hour upload link the assistant fills itself)

send

send_message, reply_send, send_draft, forward_message, only to addresses on your allowlist; optionally only after you confirm in your app's dialog

modify

modify_message (flags, folders), bulk_preview / bulk_apply (bulk archive, mark read, label, move; a preview first, then exactly those messages), set_followup, snooze, wake_snoozed

delete

trash_message and bulk trash; nothing is ever deleted permanently

Each mailbox also has a protection level for verification emails (Off, Basic, Standard, Strict, Custom; new mailboxes start at Standard): hidden mail stays out of every answer, and from Standard up codes and sign-in links in other mail are removed. It catches typical verification emails, not every possible one. Where your app supports MCP Apps, triage, digest, the draft tools and bulk_preview also show a clickable panel; switch the panels off per token on the setup page (or MAILMCP_UI=off over stdio).

Every tool is listed to the client; a call the token does not permit fails with an error naming the missing permission.

Security and data flow

  • Credentials. The setup page encrypts mailbox passwords in your browser into a split-key token. The server holds one master key, decrypts the configuration only while serving your request, keeps it in memory for at most 15 minutes after the last one, and has no database and no copy of your mail.

  • What leaves the server. IMAP/SMTP traffic to your mail provider and tool results to your assistant (so the AI vendor sees the results of every tool call, never the passwords). Licence verification is offline. The only request to the vendor is the daily update check with the usage statistics described below, and the Buy buttons link to the vendor.

  • Prompt injection. Message bodies are marked as untrusted data, hidden text is stripped and header fields are sanitized, which reduces the risk of instructions planted in an e-mail; it cannot make a model immune.

  • Protocol. OAuth 2.1 with PKCE, dynamic client registration and client metadata documents, encrypted tokens with replay guards, login throttling. Read-only defaults, send allowlists, no permanent deletion.

  • Revocation. Delete the app password at your provider; the token is then useless no matter who holds it. Outlook mailboxes carry a Microsoft refresh token instead of a password: revoke the app at account.live.com/consent/Manage or in My Apps for work accounts. Rotating MAILMCP_KEY invalidates all tokens on a server.

  • Review. An internal, AI-assisted security review of version 0.4.1 (September 2026) with every finding, fix and accepted trade-off is public: mailmcp.ai/audit.

Usage statistics

Once a day (at most) every copy asks mailmcp.ai whether a newer version exists; Claude Desktop asks at each start. Server copies (Vercel production, Docker, Node) also send usage statistics with that request unless you switch them off; Claude Desktop and other desktop (stdio) copies send them only if you turn them on, and at most once a day however often they start. The whole body is:

{"s":1,"v":"0.13","r":"docker","d":"…"}

s is the schema, v the version as major.minor, r the runtime (vercel, docker, node, claude-desktop or stdio), and d a number that stays the same for one calendar month, computed from values that never leave your server (the Vercel project id, elsewhere the machine id or a random salt the copy writes once to ~/.mailmcp/stats-salt, mixed with MAILMCP_KEY when it is set; ~/.mailmcp/stats-sent-* holds the day of each instance's last ping). No licence key, configuration, address, mailbox or content is sent. mailmcp.ai keeps only daily and monthly counts per version and per runtime; from what it stores it cannot tell which installation sent a request. Our host Vercel logs the IP address of every request for 1 day, as for any website; our code never stores it. Vercel preview deployments send only the update check; CI runs and builds from source send nothing. Every copy logs one line at start saying whether statistics are ON or OFF.

Switches (1, true, yes or on): MAILMCP_NO_STATS=1 or MAILMCP_STATS=0 (statistics off, the update check stays), MAILMCP_NO_UPDATE_CHECK=1 (no request at all), DO_NOT_TRACK=1 (statistics off). In Claude Desktop: the extension settings “Anonymous usage statistics” (off by default) and “Check for updates” (unticked, nothing is sent). Everything collected and the totals are public at mailmcp.ai/stats.

Pricing

Free

Personal, €19 once

Unlimited, €149 once

All tools included, up to 2 mailboxes in total per person (the server checks 2 per token; tokens created before 0.7.0 keep 5). Every message the assistant composes (drafts, sends, forwards) ends with "Sent with mailmcp.ai".

One user, up to 5 mailboxes in total whoever owns them, no signature, on your own server or in Claude Desktop.

One server for one organization (a company or a sole trader and its employees), unlimited users and mailboxes.

All 0.x updates are included; a 1.0 upgrade may carry a fee, and 0.x keeps working. 14-day refund, no questions asked. Company deployment, €990: two hours of online onboarding on your Vercel or cloud, Unlimited licence included. Buy at mailmcp.ai/pricing: the key appears right after payment and Stripe e-mails the invoice.

Updating

Upgrading to 0.8. Token-mode servers now need MAILMCP_INVITE_CODE (at least 8 characters), or MAILMCP_OPEN_SIGNUP=1 for a deliberately public server. Set one of the two before you deploy 0.8 (Vercel: Settings → Environment Variables → Production, then redeploy), otherwise /setup stops issuing tokens and shows a notice for you. Tokens already issued keep working either way; the full list is in CHANGELOG.md under 0.8.0. 0.8 also adds Outlook and Microsoft 365 mailboxes through a Microsoft sign-in; nothing has to be configured for that unless you want your own Entra registration or the kill switches above.

Upgrading to 0.13. Nothing has to be configured. Server copies now send the daily usage statistics described above unless you set MAILMCP_NO_STATS=1. Existing tokens keep protection Off until you pick a level on the setup page and replace the token in every assistant. In ChatGPT, refresh the connector (Settings → Connectors → mailmcp → Refresh) to see the new tools; in Claude Desktop, install the new mailmcp.mcpb. IMAP servers that support neither MOVE nor UIDPLUS now refuse moves instead of risking other messages. The full list is in CHANGELOG.md under 0.13.0.

Releases are tagged here and listed in CHANGELOG.md. If you deployed with the Vercel button, Vercel created your own copy of this repository: pull the new tag into it (git pull https://github.com/kojott/mailmcp-dist.git main and push), and Vercel deploys the push. Docker and Node: pull, rebuild or restart. To roll back, deploy the previous tag. Your tokens keep working across versions as long as MAILMCP_KEY stays the same.

Questions people ask

Google says the app-passwords setting "is not available for your account". Turn on 2-Step Verification and reload; if it is still missing, an organisation policy or Advanced Protection is blocking app passwords.

I lost my token. Tokens cannot be recovered. Create a new one on the setup page (with an edit password this time, so you can load and change it later) and swap it in your assistant.

Can the assistant send mail on its own? Only if you enabled sending, and only to addresses on the allowlist. Drafts are the safer default.

Attachment links. Download and upload links are valid for one hour and carry the token in encrypted form; anyone with the link can use it during that hour.

Licence, support, reporting problems

The licence agreement is in LICENSE (English translation first, the Czech original governs): one key, one running installation, no redistribution, no serving other people's mailboxes or running mailmcp as a hosted service without a separate agreement; removing the licence check or the free-tier signature is prohibited. This is closed-source software, so pull requests are not accepted, but bug reports in Issues are welcome. Security problems: write to info@swingingdogs.com instead of opening an issue. Privacy policy: https://mailmcp.ai/privacy, terms: https://mailmcp.ai/terms.

Guide for people: mailmcp.ai/docs. Guide for assistants, paste the link into ChatGPT or Claude and let it walk you through: mailmcp.ai/llms.txt. Support: jiridolejs.cz/kontakt.

Version 0.15.0. Made in Prague by Jiří Dolejš.

Available Tools

33 tools
awaiting_repliesFind sent mail still waiting for a replyA
Read-onlyIdempotent
Inspect

Lists threads where the owner wrote last: their newest message is older than older_than_days and no reply from someone else was found. Each item says whether the scan proved no reply (no_reply_found) or not (unknown). Needs read; every plan.

Inputs: account (required), limit, exclude, within_days, +1 more. Returns: items, accounts

bulk_applyApply a previewed bulk actionA
DestructiveIdempotent
Inspect

Applies exactly the batch a bulk_preview sealed (fewer if some changed; never more), after the owner agreed. Never deletes permanently; a repeated confirm changes nothing. Needs read and modify (trash: delete); 50 per call on Free, 500 paid.

Inputs: account (required), undo, batch, count, +2 more. Returns: object

bulk_previewPreview a bulk actionA
Read-onlyIdempotent
Inspect

Selects the exact messages a bulk action would act on (explicit uids or criteria, oldest first) and returns a count, senders, a sample and a confirm ref for bulk_apply. Changes nothing. Show the preview to the owner. Needs read and modify (trash: delete); 50 per call on Free, 500 paid.

Inputs: account (required), uids, batch, label, +6 more. Returns: cap, plan, batch, count, +2 more

create_draftCreate draftAInspect

Saves a draft in the account's Drafts folder. Nothing is sent; the owner reviews and sends it (or asks you to send_draft). Attachments: mailbox attachments, files from upload_attachment/request_upload, or inline content. The preferred way to prepare replies.

Inputs: to (required), account (required), cc, bcc, +9 more.

digestDigest since the last runA
Read-onlyIdempotent
Inspect

Read-only summary for scheduled runs: reply candidates, calendar, lists, automated mail, threads waiting on others, follow-ups and snoozes due since the cursor. Pass the returned cursor back next time; without one it covers 24 hours. Reports coverage per account. Needs read; every plan.

Inputs: limit, cursor, folder, account. Returns: cursor, triage, accounts, awaiting, +2 more

fetchFetch document (ChatGPT-compatible)A
Read-onlyIdempotent
Inspect

Returns the full sanitized text of one email by the id returned from search.

Inputs: id (required).

forward_messageForward a messageA
Destructive
Inspect

Forwards a message with all its attachments, without the files passing through the chat; the comment goes above it. Recipients must match send_allowlist; with as_draft the forward is saved to Drafts instead.

Inputs: to (required), uid (required), account (required), cc, +6 more.

get_attachmentGet attachmentAInspect

Downloads one attachment (max 2097152 bytes into the conversation; with save_to up to 26214400 bytes to disk). Text-like types and PDFs with a text layer are returned as text, others as embedded binary. Pass save_to with a directory inside policy.attachment_dirs to write the file to disk instead; the result names the path.

Inputs: uid (required), part (required), account (required), folder, +2 more.

get_messageRead a messageA
Read-onlyIdempotent
Inspect

Returns headers, sanitized text body and the attachment list of one message. Body is truncated to the configured limit.

Inputs: uid (required), account (required), folder, max_chars, +1 more. Returns: uid, text, folder

get_signatureShow the mailbox signatureA
Read-onlyIdempotent
Inspect

Returns the signature mailmcp appends under replies: the newest message in "mailmcp-signature" (HTML, inline images) when the account uses it, else the plain-text signature from the token.

Inputs: account (required).

get_threadGet conversation threadA
Read-onlyIdempotent
Inspect

Lists the conversation of a message across folders (Gmail: All Mail; other IMAP: the folder, INBOX, Sent, Archive; Outlook: whole mailbox), oldest first. coverage says what was searched and if it was complete. A thread groups by conversation; it does not prove who replied to whom.

Inputs: uid (required), account (required), folder, include_bodies. Returns: kind, coverage, messages

list_accountsList mail accountsB
Read-onlyIdempotent
Inspect

Lists the mailboxes: ids, addresses and permitted operations. backend "graph" is Outlook (string ids; labels are categories); reauth_by: when the owner must sign in to Microsoft again (setup page); plan: the mailmcp plan and, near expiry, how to renew. protection: verification emails hidden from you.

Inputs: check_connection. Returns: accounts

list_foldersList folders / labelsB
Read-onlyIdempotent
Inspect

Lists folders (Gmail: labels) with message and unseen counts. On Outlook path is an opaque id and name the hierarchy ("Projects/2026"); tools accept either as a folder.

Inputs: account (required). Returns: account, folders

list_followupsList follow-ups and snoozed mailA
Read-onlyIdempotent
Inspect

Shows due follow-ups (optionally later ones) and snoozed messages across one or all mailboxes, including flags set in Outlook itself. Read-only; reports what it could not cover. Needs read; every plan.

Inputs: account, continue, due_before, include_later, +1 more.

list_templatesList templates and writing samplesA
Read-onlyIdempotent
Inspect

Lists templates in "mailmcp-templates", or one in full by name. samples=true returns the style profile and samples of the owner's sent mail, for tone, length and language only. Needs read; every plan.

Inputs: account (required), n, to, name, +3 more.

list_uploadsList uploaded filesA
Read-onlyIdempotent
Inspect

Files waiting in "mailmcp-uploads" of an account (from upload_attachment or an upload link), newest first, with the {folder, uid, part} needed to attach them.

Inputs: account (required).

modify_messageModify messageA
DestructiveIdempotent
Inspect

Mark read/unread, star/unstar, add/remove labels (Gmail labels, Outlook categories), move to a folder or archive. A move can change the id of the message: when the result carries moved_uid, use that id from then on.

Inputs: uid (required), account (required), seen, folder, +6 more.

reply_draftReply as a draftAInspect

Saves a reply to a message into Drafts, in the same thread: threading headers, "Re:" subject, recipients (sender, or all with reply_all) and the quoted original are set by the server. Use whenever the owner says "reply / write a draft" ("odpověz", "napiš koncept"). Nothing is sent.

Inputs: uid (required), account (required), html, lang, +7 more.

reply_sendReply and sendA
Destructive
Inspect

Sends a reply to a message in the same thread (threading headers, "Re:" subject, recipients and the quoted original are set by the server). Only when the owner enabled sending AND every recipient matches send_allowlist; otherwise use reply_draft. Only when the owner says "send" ("pošli", "odešli").

Inputs: uid (required), text (required), account (required), html, +5 more.

request_uploadGet an upload linkAInspect

Returns a one-hour HTTPS upload link: PUT/POST a file to it (curl -T file , or open it in a browser); the file lands in "mailmcp-uploads" and appears in list_uploads. Anyone with the link can upload. Upload it yourself if you can run commands; otherwise give the link to the user.

Inputs: account (required).

save_templateSave or delete a templateA
DestructiveIdempotent
Inspect

Saves a text template, or with kind=profile a style profile (tone only), in "mailmcp-templates"; delete=true moves one mailmcp saved to Trash. Needs draft; templates are paid, profiles and deleting free.

Inputs: name (required), account (required), kind, text, +2 more. Returns: name

search_messagesSearch messagesA
Read-onlyIdempotent
Inspect

Searches one account, or all with account="all". Gmail: query takes Gmail syntax (from:, newer_than:7d, has:attachment, label:); elsewhere full text plus the filters. Newest first, with uid + folder and header hints. Outlook: total counts returned results only; from is exact.

Inputs: account (required), to, from, limit, +9 more. Returns: count, messages

send_draftSend a saved draftA
Destructive
Inspect

Sends a draft exactly as stored in the Drafts folder (including its attachments); it leaves Drafts (on Outlook it moves to Sent). Recipients are taken from the draft and must match send_allowlist.

Inputs: uid (required), account (required), folder, expect_fingerprint.

send_messageSend emailA
Destructive
Inspect

Sends an email via SMTP, optionally with attachments (existing mailbox attachments, uploaded files, inline content). Only allowed when the owner enabled sending for the account AND every recipient matches send_allowlist. Otherwise use create_draft.

Inputs: to (required), text (required), account (required), subject (required), +7 more.

set_followupSet or clear a follow-upA
DestructiveIdempotent
Inspect

Marks a message to come back to by a date: a record in "mailmcp-state" plus a star or flag. It resurfaces when list_followups or a scheduled task runs; clear=true removes it. Needs read and modify; setting is paid, clearing free.

Inputs: uid (required), account (required), tz, due, +4 more. Returns: uid, account

set_signatureSet the mailbox signatureA
DestructiveIdempotent
Inspect

Stores the signature (HTML and/or text) as a message in the folder "mailmcp-signature". With a photo or logo the owner instead mails one to themselves and moves it there. Needs the mailbox signature enabled on the setup page and the draft capability.

Inputs: account (required), html, text.

snoozeSnooze a messageA
Destructive
Inspect

Moves one message (not its thread) to "mailmcp-snoozed" until a time, noting its origin; wake_snoozed or cancel=true brings it back. Needs read and modify; paid (cancel free).

Inputs: uid (required), account (required), tz, until, +3 more. Returns: uid, account

trash_messageMove to trashB
DestructiveIdempotent
Inspect

Moves a message to the Trash folder. Never deletes permanently.

Inputs: uid (required), account (required), folder.

triageTriage recent mailA
Read-onlyIdempotent
Inspect

Sorts recent mail into reply_candidates, waiting_on, newsletter, lists, calendar, automated and other from headers only (no bodies). Items carry reasons; you and the owner decide what needs a reply. Reports coverage per account. Needs read; every plan.

Inputs: account (required), limit, since, folder, +1 more. Returns: since, counts, buckets, accounts

unsubscribeUnsubscribe from a mailing listA
DestructiveIdempotent
Inspect

Reads unsubscribe headers. The dry run (default) says if mailmcp can send an RFC 8058 one-click POST: only if your provider verified the signer's DKIM on them and the link is on its domain; else the manual link. Only when the owner asks. Needs read (execute: unsubscribe); every plan.

Inputs: uid (required), account (required), folder, confirm, +1 more. Returns: can_execute

upload_attachmentHand a file to mailmcpAInspect

Stores a file (text, or base64 for binary; up to policy.max_upload_bytes) in "mailmcp-uploads" and returns {folder, uid, part} to attach; it is removed once attached. Large or local files: request_upload.

Inputs: account (required), content (required), filename (required), encoding, +1 more.

wake_snoozedBring back snoozed mail that is dueA
Idempotent
Inspect

Moves due messages from "mailmcp-snoozed" back where they were, unread. Safe to repeat and to run concurrently. orphans=true moves snoozed mail without a record to INBOX (only when the owner asks). Needs read and modify; every plan.

Inputs: uid, account, dry_run, orphans. Returns: woken, pending

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 33 tools

    Disambiguation3/5

    The set has many adjacent tools whose boundaries rely heavily on long descriptions: search vs search_messages, fetch vs get_message, create_draft vs reply_draft, and send_message vs reply_send vs send_draft can still be confused. Most tools do have distinct roles once the description is read, but the overlap is substantial for an agent selecting a tool quickly.

    Naming Consistency3/5

    Most names use snake_case and many follow verb_noun patterns, but the set mixes bare verbs such as fetch, search, triage, digest, unsubscribe, and snooze with noun-oriented and compound names like wake_snoozed. The convention is readable but not predictable enough for a strong 4 or 5.

    Tool Count2/5

    With 33 tools, the surface is well past a comfortable scoped set for an MCP server and contains many specialized workflows such as bulk actions, templates, signatures, snoozing, follow-ups, and upload links. The breadth may be justified for a full mail client, but it is heavy for agent tool selection and risks overload.

    Completeness4/5

    The surface covers a broad email lifecycle: accounts, folders, search, message retrieval, attachments, drafts, replies, sending, forwarding, modify/trash, bulk operations, templates, signatures, follow-ups, snoozing, triage, and digest. Some gaps remain, such as explicit draft editing/listing and folder creation, but core workflows are well covered.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Hosted email for AI agents. Connect Gmail, Outlook / Microsoft 365 or any IMAP mailbox to Claude, ChatGPT, Cursor and other MCP clients, then read, search, send, organize, draft, schedule and auto-triage mail. Email is fetched live and never stored. Free for 1 inbox.
      23
      14
      AGPL 3.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables Claude and ChatGPT to read, search, and organize mail in a user's own email account, including folders, threads, attachments, drafts, and optional sending, with per-user permission levels and OAuth-secured remote connections.
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to search, read, send, reply to, organize, and bulk-delete email across multiple IMAP/SMTP mailboxes, with connection pooling and AES-256-encrypted credential storage. Supports 15+ providers through a web-based setup wizard and works with Claude, Cursor, and any MCP client.
      931 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables Claude to search, read, and draft email across multiple linked Gmail and Google Workspace mailboxes per user, with per-user isolation and Google sign-in. Self-hosted, drafts-only today, so users send from Gmail themselves.
      MIT