local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

References a Discord community for updates on the evolving MCP protocol and community engagement.
Provides configuration instructions specific to macOS for the Claude Desktop integration.
Provides distribution of the agentmail-mcp package through the Python Package Index, allowing users to easily install the MCP server.

Integración de AgentMail MCP

Un servidor simple de Protocolo de Contexto de Modelo (MCP) que se integra con AgentMail para gestionar dinámicamente las bandejas de entrada, listar mensajes y enviar o responder correos electrónicos, todo mediante un asistente de IA como Claude. Esta implementación de referencia demuestra cómo usar la API de AgentMail en un servidor MCP para gestionar las bandejas de entrada sobre la marcha.

Acerca de AgentMail

AgentMail es un proveedor de correo electrónico basado en API que permite a los agentes de IA crear bandejas de entrada sobre la marcha para enviar, recibir y gestionar correos electrónicos. Contamos con capas de inteligencia integradas en la capa de correo electrónico, optimizadas para flujos de trabajo de agentes y que permiten que los LLM puedan procesar los datos fácilmente. ¡Solicite una clave API aquí !

Nota importante

Este paquete está en desarrollo, ya que el protocolo MCP sigue evolucionando. Se actualizará en cuanto se añadan nuevas funciones. ¡Únete a nuestro Discord y a la comunidad!

Características

Cree nuevas bandejas de entrada dinámicamente sobre la marcha
Enumere y recupere las bandejas de entrada para ver qué está activo
Envíe correos electrónicos desde cualquiera de sus bandejas de entrada de AgentMail
Responder a mensajes dentro de hilos existentes
Lista de hilos y mensajes para una bandeja de entrada seleccionada
Recuperar archivos adjuntos de mensajes

Prerrequisitos

Python 3.10+
Clave API de AgentMail
(Opcional) Claude Desktop o cualquier otro front-end que admita comandos MCP

Instalación

Existe un paquete PyPi para este proyecto. Una vez instalado, puede consultarlo en la configuración de Claude Desktop (o ejecutarlo directamente) para habilitar las herramientas de gestión de correo electrónico.

PIP (Local o PyPI)

Si mantiene su propio entorno Python, simplemente instale el paquete desde su entorno virtual (desde PyPI o una fuente local):

pip install agentmail-mcp

Luego ejecuta:

agentmail-mcp --api-key="YOUR_AGENTMAIL_API_KEY"

Esto hará que el servidor se ejecute en su máquina local.

Opción 1: Usar Claude Desktop

Si desea interactuar con el servidor desde Claude Desktop, siga exactamente estos pasos.

Activa tu entorno virtual.

source .venv/bin/activate

Ejecute la línea a continuación para averiguar dónde se encuentra el paquete del servidor Agentmail MCP. Debería estar en algún directorio .venv/bin/ si instaló el paquete agentmail-mcp en el entorno virtual. Para Claude Desktop, es importante que lo haya instalado en el entorno virtual.

which agentmail-mcp

Copia la ruta que se devuelve.
Pegue la ruta en el campo command en el archivo claude_desktop_config.json .
Reinicie Claude Desktop.

Así es como debería verse el archivo claude_desktop_config.json :

{
  "mcpServers": {
    "agentmail-mcp": {
      "command": "/path/to/agentmail-mcp",
      "args": ["--api-key", "{AGENT_MAIL_API_KEY}"]
    }
  }
}

Si no tiene un archivo claude_desktop_config.json , cree uno en el siguiente directorio:

En macOS, el archivo de configuración normalmente se encuentra en: ~/Library/Application Support/Claude/claude_desktop_config.json

En Windows, normalmente se encuentra en: %APPDATA%/Claude/claude_desktop_config.json

Después de guardar, reinicie Claude Desktop para cargar el nuevo servidor MCP.

Uso

Con su servidor ejecutándose en Claude Desktop (u otro cliente MCP), puede enviar comandos a Claude en lenguaje natural que se asignan a las herramientas MCP de AgentMail. Por ejemplo: • "Crear una nueva bandeja de entrada llamada demo". • "Listar todas mis bandejas de entrada". • "Enviar un correo electrónico desde la bandeja de entrada test@agentmail.to a test@example.com con el asunto 'Hola' y el cuerpo explicando el tiempo en San Francisco de la última semana". • "Responder al mensaje más reciente en la bandeja de entrada abc123".

Internamente, Claude llama a las herramientas MCP expuestas (create_inbox, list_inboxes, send_message, etc.), que a su vez llaman a la API AgentMail.

Licencia

Licencia MIT: Este proyecto se distribuye bajo la licencia MIT. Úselo bajo su propia responsabilidad.

⸻

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

View all tools

Proporciona bandejas de entrada instantáneas a los agentes de IA. Los agentes/LLM pueden enviar, recibir y realizar acciones en bandejas de entrada aisladas. Diseñado para IA, a diferencia de Gmail. Visítenos en agentmail.to