Servidor MCP de WorkMail

Un servidor del Protocolo de Contexto de Modelo (MCP) que conecta Claude Desktop con Amazon WorkMail, proporcionando acceso al correo electrónico y al calendario a través de un transporte stdio local seguro.

Características

Related MCP server: Gmail & Calendar Multi-Account MCP Server

Seguridad

• Las credenciales se almacenan en el Llavero de macOS (cifrado por hardware en Apple Silicon), nunca en archivos de configuración o variables de entorno

• El transporte utiliza stdio (tubería local): sin servidor HTTP, sin puertos abiertos

• Cifrado en tránsito mediante HTTPS/TLS al endpoint EWS de WorkMail

• Validación de entrada en cada llamada a la herramienta mediante esquemas Zod

• Sanitización de salida que redacta los valores de las credenciales de todas las respuestas y mensajes de error

• Limitación de tasa que evita bucles de solicitud descontrolados (configurable, predeterminado 30/min)

• Protección contra escritura: send_email y create_calendar_event requieren un parámetro confirm: true

Requisitos previos

• macOS (utiliza el Llavero para el almacenamiento de credenciales)

• Node.js 20+

• Cuenta de Amazon WorkMail con autenticación de nombre de usuario/contraseña

Configuración

1. Instalar dependencias

git clone https://github.com/your-username/workmail-mcp-server.git
cd workmail-mcp-server
npm install

2. Configurar el entorno

cp .env.example .env

Edita .env si tu WorkMail está en una región diferente:

WORKMAIL_MCP_EWS_ENDPOINT=https://ews.mail.us-west-2.awsapps.com/EWS/Exchange.asmx

El endpoint EWS sigue el patrón https://ews.mail.<region>.awsapps.com/EWS/Exchange.asmx. Regiones comunes: us-east-1, us-west-2, eu-west-1.

3. Almacenar credenciales

npm run setup-credentials

Esto solicita tu correo electrónico y contraseña de WorkMail, los almacena en el Llavero de macOS y valida la conexión.

4. Compilar

npm run build

5. Registrar en Claude Desktop

Añade lo siguiente a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "workmail": {
      "command": "node",
      "args": ["/absolute/path/to/workmail-mcp-server/dist/index.js"]
    }
  }
}

Reinicia Claude Desktop. El servidor de WorkMail debería aparecer como conectado.

Configuración

Todos los ajustes son opcionales y tienen valores predeterminados razonables. Configúralos en .env o como variables de entorno:

Las variables de entorno establecidas en claude_desktop_config.json tienen prioridad sobre .env.

Uso

Una vez conectado, pide a Claude Desktop que interactúe con tu WorkMail:

• "Lista mis correos recientes"

• "Lee el correo de Sarah sobre el informe del tercer trimestre"

• "Busca en mi bandeja de entrada mensajes sobre el despliegue"

• "¿Qué reuniones tengo esta semana?"

• "Envía un correo a team@example.com sobre la actualización de estado"

• "Crea una reunión para mañana a las 2pm con Alex"

Desarrollo

# Run directly from TypeScript (no build step)
npm run dev

# Rebuild after changes
npm run build

# Re-run credential setup
npm run setup-credentials

Los registros se escriben en stderr en formato JSON. Para verlos mientras se ejecuta a través de Claude Desktop, consulta los registros del servidor MCP en las herramientas de desarrollador de Claude Desktop.

Arquitectura

Claude Desktop  <──stdio──>  MCP Server (Node.js)
                                  │
                                  ▼
                            EWS Client Layer
                                  │
                                  ▼
                  Amazon WorkMail (Exchange Web Services)

El servidor utiliza el protocolo EWS en el nivel de compatibilidad Exchange2010_SP2, que es la versión compatible con Amazon WorkMail.

Licencia

MIT