AgentMail

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):

Luego ejecuta:

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.

1. Activa tu entorno virtual.

2. 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.

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

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

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

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

⸻