mcp-mail

Name: mcp-mail
Author: Annseraf

de Annserafversión 1.0.2i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.Annseraf/mcp-mail

Instalar

Resumen

Descripción del creador (original en inglés)

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

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiAún sin medir★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Chat y correo

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: ACCOUNTS_FILE, STDIO_PRESET

Necesitas

npmNode.js instalado (para el comando npx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

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

Ejecuta esto en tu terminal

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

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

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

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

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

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

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

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 7 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub Annseraf, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Chat y correoi

Más estrellas que el 0% de los otros 1783 servidores de esta categoría
Publicado en el registro más recientemente que el 85% de los otros 1783 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 1783 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro mcp-mail?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (1.0.2) llegó al registro hace 4 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Vexa, emailmd, MCP WhatsApp Cloud

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Vexa

de Vexa-ai

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

Se ejecuta en la nube★ 2949Apache-2.0Actualizado hace 2 meses

Instalar

emailmd

de anypost

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

Computadora o nube★ 1385MITActualizado hace 31 días

Instalar

MCP WhatsApp Cloud

de codespar

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

Se ejecuta en tu computadora★ 277MITActualizado hace 5 meses

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Chat y correoi

Preguntas frecuentes

Alternativas

Vexa

emailmd

MCP WhatsApp Cloud

README del creador

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