SecureMessage Mail MCP server
Commit 7. Nov. 2026Ermöglicht es AI-Clients, E-Mail-Konten via IMAP und SMTP zu verwalten, einschließlich Suchen, Lesen, Senden und Organisieren von Nachrichten.
Auch bekannt als securemessage/mail-mcp
- Stars
- 1
- Tools
- 24
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 7. Nov. 2026
- Lizenz
- BSD-2-Clause
Was ist SecureMessage Mail MCP?
Ermöglicht es AI-Clients, E-Mail-Konten via IMAP und SMTP zu verwalten, einschließlich Suchen, Lesen, Senden und Organisieren von Nachrichten. Er stellt 24 Tools bereit, etwa mail_connect, mail_disconnect, mail_connection_status.
Zusammenfassung generiert aus dem README des Projekts
Über SecureMessage Mail MCP server
Die direkte Verwaltung von E-Mail-Konten aus einem AI-Client heraus ist das, was dieser PHP-basierte Server ermöglicht. Er erlaubt es Entwicklern und Nutzern, Nachrichten über die Protokolle IMAP und SMTP zu suchen, zu lesen, zu senden und zu organisieren. Der Server unterstützt mehrere Konten, die zur Laufzeit gewechselt werden können, und arbeitet mit Anbietern wie Gmail, Microsoft 365 und Yahoo über die XOAUTH2-Authentifizierung zusammen.
Der Server läuft auf PHP 8.4 und wird als einzelne PHAR-Datei ausgeliefert, die keine externen Abhängigkeiten wie Node.js oder Composer benötigt. Er bietet 22 spezifische Tools, darunter mail_search mit über 12 Filterparametern, mail_get_thread für den Gesprächsverlauf und mail_create_draft zum Vorbereiten von Nachrichten. Nutzer können ihn in Claude Desktop oder Windsurf integrieren, indem sie den Befehl zum Ausführen der PHAR-Datei konfigurieren.
Dieses Tool ist einzigartig, da es reine PHP-Socket-Clients verwendet, anstatt sich auf die ext-imap Extension zu verlassen. Es bewältigt komplexe Aufgaben wie das Verschieben von Nachrichten zwischen Ordnern, das Verwalten von Flags und das Abrufen von Anhängen. Es ist für das lokale Deployment konzipiert, bei dem ein AI Agent über eine einheitliche Schnittstelle mit verschiedenen Mailboxen interagieren kann.
Was du damit machen kannst
- 1Durch mehrere Mailboxen suchenFinde spezifische E-Mails mithilfe verschiedener Filter wie Absender, Betreff oder Datum über alle Ordner hinweg.
- 2E-Mail-Ordner organisierenVerschiebe Nachrichten zwischen verschiedenen Ordnern und verwalte Labels oder Flags.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
SecureMessage Mail MCP tools 24
Erkannt aus dem 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 | — |
Alle 24 Tools anzeigenWeniger Tools anzeigen
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 | — |
Konfiguration
MAIL_MCP_CONFIG
| Name | Beschreibung | Typ |
|---|---|---|
| MAIL_MCP_CONFIG | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarsecuremessage/mail-mcp is public and reachablegithub.com/securemessage/mail-mcp ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)BSD-2-Clausespdx.org/licenses/BSD-2-Clause.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-07github.com/securemessage/mail-mcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell24 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenSecureMessage 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.
SecureMessage Mail MCP Fragen
Welche Tools bietet SecureMessage Mail MCP?
Er stellt 24 Tools bereit, darunter mail_connect, mail_disconnect, mail_connection_status, mail_list_mailboxes, mail_open_mailbox.
Welche Authentifizierungsmethoden werden unterstützt?
Der Server unterstützt die Standard-Passwort-Authentifizierung sowie OAuth/XOAUTH2 für Anbieter wie Gmail, Microsoft 365 und Yahoo.
Sind externe Abhängigkeiten wie Node.js oder Composer erforderlich?
Nein, er nutzt reine PHP-Socket-Clients und benötigt keine externen Abhängigkeiten außer PHP 8.4 und bestimmten Standard-Extensions.
Kann ich mehrere E-Mail-Konten gleichzeitig verwalten?
Ja, der Server unterstützt Multi-Account-Management und erlaubt es dir, zur Laufzeit zwischen den Konten zu wechseln.