mcp-mail

Name: mcp-mail
Author: Annseraf

作者：Annserafバージョン 1.0.2i★ –iパソコンで動く

レジストリ名io.github.Annseraf/mcp-mail

インストール

概要

作者による説明（英語の原文）

Self-hosted IMAP/SMTP email for any MCP client, with per-client permissions and audit log.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: チャット・メール

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： ACCOUNTS_FILE, STDIO_PRESET

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "mail": {
      "command": "npx",
      "args": [
        "-y",
        "@annseraf/mcp-mail",
        "stdio"
      ],
      "env": {
        "ACCOUNTS_FILE": "your-value",
        "STDIO_PRESET": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add mail --env ACCOUNTS_FILE=your-value --env STDIO_PRESET=your-value -- npx -y @annseraf/mcp-mail stdio

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "mail": {
      "command": "npx",
      "args": [
        "-y",
        "@annseraf/mcp-mail",
        "stdio"
      ],
      "env": {
        "ACCOUNTS_FILE": "your-value",
        "STDIO_PRESET": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "mail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@annseraf/mcp-mail",
        "stdio"
      ],
      "env": {
        "ACCOUNTS_FILE": "your-value",
        "STDIO_PRESET": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

ACCOUNTS_FILE env
Path to accounts.json (default ~/.config/mcp-mail/accounts.json)
STDIO_PRESET env
read-only | read-draft | organize | full-no-delete | full

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント Annseraf で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

チャット・メールのほかのサーバーとの比較i

このカテゴリのほかの1783件のうち0%よりスターが多い
このカテゴリのほかの1783件のうち85%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの1783件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

mcp-mailは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（1.0.2）がレジストリに届いたのは4 日前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：Vexa, emailmd, MCP WhatsApp Cloud

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Vexa

作者：Vexa-ai

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

クラウドで動く★ 2,949Apache-2.02 か月前更新

インストール

emailmd

作者：anypost

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

パソコンでもクラウドでも★ 1,385MIT31 日前更新

インストール

MCP WhatsApp Cloud

作者：codespar

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

パソコンで動く★ 277MIT5 か月前更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

mcp-mail

mcp-mail is a self-hosted IMAP/SMTP email MCP server that lets Claude, ChatGPT, Cursor and any other MCP client read, search, draft and send email from your existing mailbox, with per-client permissions, an audit log and a one-line install.

curl -fsSL https://raw.githubusercontent.com/Annseraf/mcp-mail/main/install.sh | sudo bash -s -- --auto-update

Local clients (Claude Desktop, Claude Code, Cursor, VS Code) can run it directly: npx -y @annseraf/mcp-mail stdio.

mcp-mail is a maintained continuation of claude-mail-mcp by Markus Stöger (MIT). Existing claude-mail-mcp v0.2 installs can switch with no config changes (compatibility contract).

Works with

AI clients: Claude.ai, Claude Desktop, Claude Code, ChatGPT (developer mode, deep research), Cursor, VS Code, Meta Muse, and any MCP client over Streamable HTTP or stdio. Setup guides: docs/clients.
Mail providers: any IMAP/SMTP mailbox: Fastmail, iCloud, Purelymail, Gmail and Google Workspace (app password), Yahoo, Zoho, Mailbox.org, Migadu, Mailcow, Dovecot/Postfix.
Calendars: any CalDAV server (Fastmail, iCloud, Nextcloud, Radicale), optional.
MCP protocol: 2026-07-28 (stateless) and every earlier revision since 2024-11-05, on the same endpoint.

Tools

Tool	What it does	Capability
`list_accounts`	List connected mailboxes, sender names and signatures (never credentials)	read
`list_folders`	List folders with their special use (Inbox, Sent, Drafts, Trash)	read
`list_messages`	Newest messages in a folder, with short previews	read
`search_messages`	Search one folder, several, or all (`"*"`) by sender, subject, body, date, read or flagged	read
`get_message`	Read one message: headers, body, attachment list, threading ids	read
`get_attachment`	Download one attachment (size-capped)	read
`get_thread`	Read a whole conversation across Inbox and Sent, oldest first	read
`list_threads`	Group a folder's newest messages into conversations	read
`create_draft`	Save a draft (with attachments); `reply_to_uid` fills in the reply for you	draft
`mark_read`	Mark a message read or unread	organize
`set_flags`	Star (flag), mark answered, or add custom keywords	organize
`move_message`	Move a message to another folder	organize
`delete_message`	Move to Trash; `permanent: true` deletes for good	organize / destructive
`send_message`	Send an email (with attachments and signature); a copy goes to Sent	send
`update_account_settings`	Change the sender display name and signature	settings
`list_calendars`, `list_events`, `find_free_slot`	Read calendars and find free time	calendar-read
`create_event`	Create a calendar event	calendar-write
`search`, `fetch`	ChatGPT deep research adapters (`CHATGPT_COMPAT=true`)	read

Comparison

	mcp-mail	claude-mail-mcp v0.2
Transport	Streamable HTTP (2026-07-28 + legacy) and stdio	Streamable HTTP
Auth	Built-in OAuth 2.1 (DCR, PKCE), per-client tokens, shared token	Shared token + separate OAuth shim
Per-client permissions	Presets, tool allow/deny, mailbox scope, recipient allowlist, send rate limit	—
Read-only mode	`read-only` preset (or `STDIO_PRESET=read-only`)	—
Revoke one client	Yes, others keep working	Rotate the shared secret
Attachments	Send, draft and download	Send only
Threads, flags, multi-folder search	Yes	—
Audit log	JSONL, no message content	—
Prompt-injection hygiene	Untrusted-content fencing, hidden-HTML stripping, server instructions	—
Multi-tenant + admin API	Opt-in, with OpenAPI spec	—
Install and updates	One-line installer, signed releases, auto-update with rollback	Manual

Other IMAP MCP servers worth a look, depending on your needs: codefuturist/email-mcp (TypeScript, IMAP/SMTP, many tools), tecnologicachile/mail-mcp (Rust, IMAP/SMTP plus Microsoft Graph and EWS) and wildsurfer/your-mail-mcp (read-only, local notmuch index). Check their READMEs for current features.

FAQ

How do I give ChatGPT read-only access to my email?

Run mcp-mail clients add chatgpt --for chatgpt (OAuth login, read-only preset), enable OAUTH=true, and add the server in ChatGPT's developer mode. ChatGPT only ever sees the read tools. See docs/clients/chatgpt.md.

Can I use this with Fastmail, iCloud, Purelymail or Gmail?

Yes. Anything that speaks IMAP and SMTP works. For Gmail, iCloud, Yahoo and Fastmail, create an app password in the provider's security settings and use it instead of your normal password.

How do I stop an AI agent from sending email?

Give the agent a preset without send (read-only, read-draft or organize). The send tool then disappears from its tool list and is rejected if called anyway. For agents that may send, restrict recipients with sendRecipientAllowlist and cap volume with sendRateLimit. See docs/CLIENTS.md.

Can an email trick the AI into doing something?

Emails are untrusted input. mcp-mail wraps every body in untrusted-content delimiters, strips hidden HTML text and tracking pixels, and tells clients to confirm sends and deletions with you. Keep sending off for agents that don't need it. See SECURITY.md.

Does deleting a message lose it forever?

No. delete_message moves the message to Trash. Permanent deletion needs permanent: true and a client with the destructive capability.

Where are my passwords stored?

In accounts.json on your server (optionally encrypted at rest with mcp-mail secrets encrypt). In multi-tenant mode, credentials are envelope-encrypted per tenant with a local key file or OCI Vault. They are never returned by any tool, API or log.

Can my agent sign emails?

Yes. Each account can have a sender display name and a signature, set in accounts.json or by the agent itself with update_account_settings. Pass include_signature: false to send without it.

I'm on claude-mail-mcp. Do I need to change anything?

No. Swap the binary; your .env, accounts.json and connected clients keep working. CI enforces this against recorded v0.2.1 behavior.

Security model

Binds to 127.0.0.1 by default; put nginx or Caddy in front for TLS.
Clients authenticate with OAuth 2.1 (PKCE, rotating refresh tokens), per-client static tokens (stored hashed), or the legacy shared token.
Every tool call is checked against the client's policy twice: when listing tools and when calling them.
The audit log records who did what, never message content.
Mail content is fenced as untrusted; sends and deletions should be confirmed by a human.
Releases are built by CI from tagged commits only, with checksums and provenance attestation.

Details: SECURITY.md, docs/CLIENTS.md, docs/PLATFORM.md.

Configuration

.env: transport settings (.env.example). Everything new is optional.
accounts.json: mailboxes (same format as claude-mail-mcp; optional fromName/signature).
clients.json: per-client identities and policies (docs/CLIENTS.md).
Multi-tenant mode and the admin API: docs/PLATFORM.md.

Upgrading

From claude-mail-mcp v0.2.x: no config changes required. Install mcp-mail pointing at the same .env, accounts.json and (if you use one) OAuth state. New features stay off until you enable them. Two approved behavior changes are listed in docs/COMPATIBILITY.md: deleting moves to Trash, and email content is fenced as untrusted (UNTRUSTED_FENCING=false restores the old output).

Development

npm ci

npm run check # lint, format, typecheck, unit tests, license scan, build npm run test:compat # compatibility gate + integration suites (needs GreenMail, see docs/COMPATIBILITY.md)

Adding a tool: docs/ADDING_A_TOOL.md. Contributions: CONTRIBUTING.md.

mcp-mail

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

チャット・メールのほかのサーバーとの比較i

よくある質問

代わりの候補

Vexa

emailmd

MCP WhatsApp Cloud

作者のREADME

mcp-mail

Works with

Tools

Comparison

FAQ

How do I give ChatGPT read-only access to my email?

Can I use this with Fastmail, iCloud, Purelymail or Gmail?

How do I stop an AI agent from sending email?

Can an email trick the AI into doing something?

Does deleting a message lose it forever?

Where are my passwords stored?

Can my agent sign emails?

I'm on claude-mail-mcp. Do I need to change anything?

Security model

Configuration

Upgrading

Development

License