mail-mcp

Construido sobre davidvornholt/standards.

Un asistente IMAP solo para borradores para flujos de trabajo de Thunderbird, expuesto a Codex, Claude y otros clientes compatibles como un servidor MCP y para ti como una CLI mail sobre un núcleo Effect compartido. A través del servidor MCP puede buscar y leer correos y archivos adjuntos recibidos, y crear, actualizar o eliminar borradores con HTML y archivos adjuntos; la CLI mail cubre inicio de sesión, estado, búsqueda/lectura de carpetas y creación de borradores en texto plano. No puede enviar correos: los borradores se sincronizan en Thunderbird para su revisión y envío.

Layout

apps/mail            the application (MCP server + CLI)
  src/app            entrypoints: server.ts (MCP, stdio), cli.ts (the `mail` bin)
  src/features/mail  schemas, tagged errors, and Effect services (config, secrets, status, IMAP, draft, login)
  src/shared         app-local infrastructure (arg parsing, hidden-input terminal prompt)
packages/*           canonical shared config synced from the standards template

Consulta apps/mail/README.md para la lista de herramientas, configuración y manejo de secretos.

Related MCP server: imap-mcp

Setup

bun install

# put the `mail` command on your PATH (one-time; links the app's bin into
# ~/.bun/bin). After this, run `mail …` from anywhere.
bun link --cwd apps/mail

# configure your accounts (non-secret: addresses, IMAP hosts, and ports). The real
# file is git-ignored so your addresses never land in git.
cp apps/mail/accounts.example.toml apps/mail/accounts.toml
# …edit apps/mail/accounts.toml…

# verify every account's password against IMAP, then store each in the OS keyring
# (hidden prompts — nothing is echoed or written to disk). Run this yourself;
# the secrets never leave your machine.
mail login

# confirm each account authenticates cleanly (or shows what still needs a login)
mail status

Registra el servidor MCP con Codex:

codex mcp add mail -- bun run <repo>/apps/mail/src/app/server.ts
codex mcp get mail

Codex difiere las definiciones de herramientas MCP hasta que sean relevantes, por lo que registrar el servidor no añade de forma anticipada cada esquema de herramienta de correo al contexto del modelo. Reinicia Codex después de añadirlo y luego usa /mcp para inspeccionar el servidor conectado.

Para aprobaciones de escritura explícitas y más margen para operaciones IMAP, edita la entrada generada en ~/.codex/config.toml:

[mcp_servers.mail]
command = "bun"
args = ["run", "<repo>/apps/mail/src/app/server.ts"]
startup_timeout_sec = 15
tool_timeout_sec = 120
default_tools_approval_mode = "writes"

[mcp_servers.mail.tools.delete_draft]
approval_mode = "prompt"

Para Claude Code (ámbito de usuario), usa:

claude mcp add --scope user mail -- bun run <repo>/apps/mail/src/app/server.ts

Una vez que se almacena una contraseña, pide a tu cliente MCP que busque tu correo o redacte un borrador. También puedes usar tú mismo la CLI de revisión primero:

mail search invoice
mail search --account you@example.com invoice

Omitir --account busca en todas las cuentas configuradas, combina y deduplica los resultados, y aplica el límite globalmente. Pasa --account <email> para buscar solo en esa cuenta. Cada resultado incluye su identificador de cuenta, y los fallos de cuentas individuales se informan junto con los resultados parciales. Si todas las cuentas fallan, el comando falla con todos los errores de cuenta.

Las búsquedas de carpetas son específicas de la cuenta: usa mail search --account you@example.com --scope folder --folder INBOX ... para una carpeta exacta o --scope subtree --folder Projects para una carpeta y sus descendientes.

¿No estás listo para vincular un comando global? Cada ejemplo también funciona como bun run apps/mail/src/app/cli.ts <args>.

Requirements

• Bun (consulta packageManager en package.json).

• Un proveedor de Secret Service en ejecución y desbloqueado (gnome-keyring) para el llavero del sistema operativo.

Quality gate

bun run check ejecuta la comprobación de desviación de estándares, luego lint, type-check, pruebas, compilación y a11y en cada espacio de trabajo. Debe pasar antes de que un cambio esté completo.