Servidor MCP de Fastmail (No oficial)

Servidor del Protocolo de Contexto de Modelo (MCP) no oficial para la integración con Fastmail. Expone una única herramienta execute que actúa como un proxy JMAP validado: el LLM escribe llamadas a métodos JMAP sin procesar y el servidor se encarga de la validación, la autenticación y la limpieza de la respuesta.

Instrucciones de configuración

1. Obtén tu token de API de Fastmail

1. Inicia sesión en Fastmail

2. Ve a Settings (Configuración) → Privacy & Security (Privacidad y seguridad) → API tokens

3. Haz clic en New API token (Nuevo token de API)

4. Asígnale un nombre (p. ej., "Claude MCP")

5. Selecciona los alcances necesarios: Mail (lectura/escritura según sea necesario)

6. Copia el token generado

2. Configura Claude Code

Añade lo siguiente a tu configuración de MCP de Claude Code (~/.claude/claude_desktop_config.json o .mcp.json del proyecto):

{
  "mcpServers": {
    "fastmail": {
      "type": "url",
      "url": "https://fastmail-mcp.i11v.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_FASTMAIL_API_TOKEN"
      }
    }
  }
}

Nota de seguridad: Mantén tu token de API seguro. Nunca lo subas al control de versiones. Considera usar variables de entorno o un gestor de secretos.

Herramientas disponibles

execute

Ejecuta llamadas a métodos JMAP contra Fastmail. Acepta una matriz de triples de llamadas a métodos JMAP [methodName, args, callId].

Entrada:

{
  "methodCalls": [
    ["Email/query", {
      "filter": { "inMailbox": "INBOX_ID" },
      "sort": [{ "property": "receivedAt", "isAscending": false }],
      "limit": 10
    }, "call-0"],
    ["Email/get", {
      "ids": { "resultOf": "call-0", "name": "Email/query", "path": "/ids" },
      "properties": ["from", "subject", "receivedAt", "preview"]
    }, "call-1"]
  ]
}

Lo que hace el servidor:

• Valida la estructura, los nombres de los métodos y las reglas de higiene

• Inyecta el accountId automáticamente

• Envía a la API JMAP de Fastmail

• Elimina el ruido del protocolo (state, queryState, canCalculateChanges, etc.)

• Devuelve methodResponses limpias

Métodos JMAP permitidos:

• Core/echo

• Mailbox/get, Mailbox/query, Mailbox/queryChanges, Mailbox/set

• Email/get, Email/query, Email/queryChanges, Email/set

• Thread/get

• SearchSnippet/get

• Identity/get

• EmailSubmission/get, EmailSubmission/query, EmailSubmission/set

Reglas de validación:

• Cada llamada /get (excepto Mailbox/get, Identity/get) debe incluir una matriz properties

• Cada llamada /query debe incluir un limit

• Se rechaza ids: null en llamadas /get (usa /query primero)

• Las operaciones destructivas (destroy, EmailSubmission/set) devuelven un error solicitando la confirmación del usuario

compose_email (Aplicación MCP)

Abre un formulario interactivo para redactar correos electrónicos. Opcionalmente, rellena previamente los campos (para, cc, bcc, asunto, cuerpo). En hosts que admiten aplicaciones MCP, renderiza una interfaz de redacción integrada con botones de enviar y guardar borrador. En otros hosts, recurre a texto estructurado.

Entrada:

{
  "to": "recipient@example.com",
  "subject": "Hello",
  "body": "Message text..."
}

read_email (Aplicación MCP)

Muestra el contenido completo de un correo electrónico en una vista de lectura enriquecida. Recupera el correo electrónico por ID de JMAP y renderiza encabezados, cuerpo saneado y botones de acción (responder, responder a todos, reenviar). En hosts sin soporte para aplicaciones MCP, recurre a texto estructurado.

Entrada:

{
  "emailId": "M1234abcd"
}

Recursos disponibles

Los clientes MCP que admiten recursos reciben automáticamente la habilidad de Fastmail: un conjunto de archivos markdown que enseñan al LLM cómo manejar la herramienta JMAP execute. Los clientes que admiten prioridad de recursos cargarán SKILL.md primero y seguirán sus enlaces de forma diferida.

Todos los recursos utilizan el esquema URI file:///fastmail-skill/<path> y el tipo mime text/markdown. Etiquetado como audience: ["assistant"].

Puntos finales de la API

• POST /mcp - Punto final del protocolo MCP

• GET /health - Punto final de comprobación de estado

Variables de entorno

Copia .env.example a .env.development.local y rellena los valores:

cp .env.example .env.development.local

Desarrollo

pnpm install   # Install dependencies
pnpm dev       # Run local dev server (wrangler)
pnpm check     # Run all checks (typecheck + lint + fmt + test)
pnpm run deploy:prod  # Deploy to Cloudflare

Este es un proyecto comunitario no oficial y no está afiliado a Fastmail.

Código fuente y problemas: GitHub