MCP server de SecureMessage Mail
Commit 7 nov 2026Permite que los clientes de IA gestionen cuentas de correo electrónico a través de IMAP y SMTP, incluyendo la búsqueda, lectura, envío y organización de mensajes.
También conocido como securemessage/mail-mcp
- Stars
- 1
- Herramientas
- 24
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 7 nov 2026
- Licencia
- BSD-2-Clause
¿Qué es SecureMessage Mail MCP?
Permite que los clientes de IA gestionen cuentas de correo electrónico a través de IMAP y SMTP, incluyendo la búsqueda, lectura, envío y organización de mensajes. Expone 24 herramientas, como mail_connect, mail_disconnect, mail_connection_status.
Resumen generado a partir del README del proyecto
Acerca del MCP server de SecureMessage Mail
Gestionar cuentas de correo electrónico directamente desde un cliente de IA es lo que permite este servidor basado en PHP. Permite a desarrolladores y usuarios buscar, leer, enviar y organizar mensajes utilizando los protocolos IMAP y SMTP. El servidor admite múltiples cuentas que se pueden cambiar en tiempo de ejecución y funciona con proveedores como Gmail, Microsoft 365 y Yahoo mediante la autenticación XOAUTH2.
Ejecutado en PHP 8.4, el servidor se distribuye como un único archivo PHAR que no requiere dependencias externas como Node.js o Composer. Proporciona 22 herramientas específicas, incluyendo mail_search con más de 12 parámetros de filtrado, mail_get_thread para el historial de conversaciones y mail_create_draft para preparar mensajes. Los usuarios pueden integrarlo en Claude Desktop o Windsurf configurando el comando para ejecutar el archivo PHAR.
Esta herramienta es única porque utiliza clientes de sockets de PHP puro en lugar de depender de la extensión ext-imap. Gestiona tareas complejas como mover mensajes entre carpetas, administrar flags y recuperar archivos adjuntos. Está diseñado para despliegues locales donde un agente de IA puede interactuar con varios buzones de correo a través de una interfaz unificada.
Qué puedes hacer con él
- 1Buscar en múltiples buzonesEncuentra correos electrónicos específicos utilizando varios filtros como remitente, asunto o fecha en todas las carpetas.
- 2Organizar carpetas de correoMueve mensajes entre diferentes carpetas y gestiona etiquetas o flags.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Herramientas de SecureMessage Mail MCP 24
Detectado desde el READMEmail_connectmail_disconnectmail_connection_statusmail_list_mailboxesmail_open_mailboxmail_create_mailboxmail_searchmail_get_messagemail_get_headersmail_get_messagesmail_get_threadmail_delete_message
| mail_connect | — | |
| mail_disconnect | — | |
| mail_connection_status | — | |
| mail_list_mailboxes | — | |
| mail_open_mailbox | — | |
| mail_create_mailbox | — | |
| mail_search | — | |
| mail_get_message | — | |
| mail_get_headers | — | |
| mail_get_messages | — | |
| mail_get_thread | — | |
| mail_delete_message | — |
Mostrar las 24 herramientasMostrar menos herramientas
mail_sendmail_replymail_create_draftmail_update_draftmail_mark_readmail_mark_unreadmail_set_flagsmail_move_messagemail_get_attachmentsmail_save_attachmentmail_list_instancesmail_switch_instance
| mail_send | — | |
| mail_reply | — | |
| mail_create_draft | — | |
| mail_update_draft | — | |
| mail_mark_read | — | |
| mail_mark_unread | — | |
| mail_set_flags | — | |
| mail_move_message | — | |
| mail_get_attachments | — | |
| mail_save_attachment | — | |
| mail_list_instances | — | |
| mail_switch_instance | — |
Configuración
MAIL_MCP_CONFIG
| Nombre | Descripción | Tipo |
|---|---|---|
| MAIL_MCP_CONFIG | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblesecuremessage/mail-mcp is public and reachablegithub.com/securemessage/mail-mcp ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)BSD-2-Clausespdx.org/licenses/BSD-2-Clause.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-07github.com/securemessage/mail-mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo24 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubSecureMessage Mail MCP Server
A PHP Model Context Protocol server for IMAP/SMTP email operations, built on the Enchilada Framework. Part of the SecureMessage project.
Uses pure PHP socket IMAP/SMTP clients — no ext-imap, no Composer, no Node.js. Zero external dependencies beyond PHP 8.4 with openssl, curl, iconv, ctype, and fileinfo.
Features
- 22 tools — search, read, send, reply, drafts, attachments, threads, move, flags
- Multi-account — manage multiple mail accounts, switchable at runtime
- Unified search — single tool with 12+ filter parameters, multi-mailbox search across all folders
- Drafts — create drafts for review before sending
- Organization — move messages between folders, manage flags/labels
- Threads — retrieve full conversation threads
- OAuth/XOAUTH2 — Gmail, Microsoft 365, Yahoo via XOAUTH2 authentication
- PHAR deployment — single-file distribution, no installation required
- Built on the EnchiladaMCP library
Requirements
- PHP 8.4+ with
openssl,curl,iconv,ctype,fileinfo, andpharextensions - An IMAP/SMTP mail account (Gmail, Outlook, Fastmail, self-hosted, etc.)
Quick Start (PHAR)
Download the latest PHAR from Releases:
curl -LO https://pacyworld.dev/securemessage/mail-mcp/releases/download/v1.1.6/mail-mcp.phar
chmod +x mail-mcp.phar
Create a config file:
mkdir -p ~/.config/mail-mcp
cat > ~/.config/mail-mcp/instances.json << 'EOF'
{
"default": "personal",
"instances": {
"personal": {
"imap_host": "imap.example.com",
"imap_port": 993,
"smtp_host": "smtp.example.com",
"smtp_port": 465,
"username": "user@example.com",
"password": "your-app-password",
"tls": true
}
}
}
EOF
Start the server:
php mail-mcp.phar
For OAuth, multi-instance, and provider-specific settings, see docs/SETUP.md.
From Source
git clone https://pacyworld.dev/securemessage/mail-mcp.git
cd mail-mcp
cp config/instances.json.sample config/instances.json
# Edit config/instances.json with your mail server details
php bin/mail-mcp
AI Assistant Configuration
Windsurf / Cascade
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mail": {
"command": "php",
"args": ["/path/to/mail-mcp.phar"]
}
}
Claude Code / Claude Desktop
{
"mcpServers": {
"mail": {
"command": "php",
"args": ["/path/to/mail-mcp.phar"]
}
}
}
To use a config file in a non-default location:
{
"mail": {
"command": "php",
"args": ["/path/to/mail-mcp.phar"],
"env": {
"MAIL_MCP_CONFIG": "/path/to/instances.json"
}
}
}
Available Tools
| Tool | Description |
|---|---|
mail_connect |
Connect to IMAP/SMTP for a mail account |
mail_disconnect |
Disconnect from mail servers |
mail_connection_status |
Show connection state for all accounts |
mail_list_mailboxes |
List available folders |
mail_open_mailbox |
Select a folder (returns message counts) |
mail_create_mailbox |
Create a new folder |
mail_search |
Search with flexible filters (from, to, cc, subject, body, date, flags, keywords) |
mail_get_message |
Fetch single message with full content |
mail_get_headers |
Fetch raw RFC 5322 headers, folding and repeats intact |
mail_get_messages |
Fetch multiple messages (headers only) |
mail_get_thread |
Retrieve full conversation thread |
mail_delete_message |
Delete a message |
mail_send |
Send a new email (with file attachments) |
mail_reply |
Reply with quoted original message |
mail_create_draft |
Save a draft for review before sending |
mail_update_draft |
Modify an existing draft (recipients, subject, body, attachments) |
mail_mark_read |
Mark message(s) as read |
mail_mark_unread |
Mark message(s) as unread |
mail_set_flags |
Add/remove IMAP flags and keywords |
mail_move_message |
Move messages between folders |
mail_get_attachments |
List attachment metadata |
mail_save_attachment |
Save attachment to file or return as base64 |
mail_list_instances |
List configured accounts |
mail_switch_instance |
Change default account |
All tools accept an optional instance parameter to target a specific mail account.
Agent Skill
For AI-assisted setup, point your AI agent to the setup skill.
Documentation
- docs/SETUP.md — Full setup guide (auth methods, providers, IDE integration, troubleshooting)
- docs/OAUTH.md — OAuth setup for Gmail, Google Workspace, Microsoft 365
- docs/TOOLS.md — Complete tool reference with all parameters
- docs/AGENT_SKILL.md — Agent skill for AI-assisted installation
License
BSD 2-Clause — see LICENSE.
Preguntas sobre SecureMessage Mail MCP
¿Qué herramientas proporciona SecureMessage Mail MCP?
Expone 24 herramientas, incluidas mail_connect, mail_disconnect, mail_connection_status, mail_list_mailboxes, mail_open_mailbox.
¿Qué métodos de autenticación son compatibles?
El servidor admite la autenticación estándar por contraseña y OAuth/XOAUTH2 para proveedores como Gmail, Microsoft 365 y Yahoo.
¿Requiere dependencias externas como Node.js o Composer?
No, utiliza clientes de sockets de PHP puro y no requiere dependencias externas más allá de PHP 8.4 y algunas extensiones estándar específicas.
¿Puedo gestionar varias cuentas de correo a la vez?
Sí, el servidor admite la gestión de múltiples cuentas y permite cambiar entre ellas en tiempo de ejecución.