SecureMessage Mail MCP sunucusu
Commit 7 Kas 2026AI istemcilerinin IMAP ve SMTP üzerinden e-posta hesaplarını yönetmesini; mesajları aramasını, okumasını, göndermesini ve düzenlemesini sağlar.
Ayrıca bilinen adı securemessage/mail-mcp
- Yıldızlar
- 1
- Araçlar
- 24
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 7 Kas 2026
- Lisans
- BSD-2-Clause
SecureMessage Mail MCP nedir?
AI istemcilerinin IMAP ve SMTP üzerinden e-posta hesaplarını yönetmesini; mesajları aramasını, okumasını, göndermesini ve düzenlemesini sağlar. 24 araç sunar; örneğin mail_connect, mail_disconnect, mail_connection_status.
Özet, projenin README dosyasından oluşturuldu
SecureMessage Mail MCP sunucusu hakkında
Bu PHP tabanlı sunucu, e-posta hesaplarının doğrudan bir AI istemcisi üzerinden yönetilmesini sağlar. Geliştiricilerin ve kullanıcıların IMAP ve SMTP protokollerini kullanarak mesajları aramasını, okumasını, göndermesini ve düzenlemesini mümkün kılar. Sunucu, çalışma zamanında değiştirilebilen birden fazla hesabı destekler ve XOAUTH2 kimlik doğrulaması aracılığıyla Gmail, Microsoft 365 ve Yahoo gibi sağlayıcılarla çalışır.
PHP 8.4 üzerinde çalışan sunucu, Node.js veya Composer gibi harici bağımlılıklar gerektirmeyen tek bir PHAR dosyası olarak dağıtılır. 12'den fazla filtre parametresine sahip mail_search, konuşma geçmişi için mail_get_thread ve mesaj hazırlamak için mail_create_draft dahil olmak üzere 22 özel araç sunar. Kullanıcılar, PHAR dosyasını çalıştıracak komutu yapılandırarak bu aracı Claude Desktop veya Windsurf içine entegre edebilirler.
Bu araç, ext-imap eklentisine güvenmek yerine saf PHP socket istemcilerini kullandığı için benzersizdir. Mesajları klasörler arasında taşıma, bayrakları yönetme ve ekleri alma gibi karmaşık görevleri yerine getirir. Bir AI agent'ın birleşik bir arayüz üzerinden çeşitli posta kutularıyla etkileşime girebileceği yerel kurulumlar için tasarlanmıştır.
Neler yapabilirsiniz
- 1Birden fazla posta kutusunda arama yapmaTüm klasörler arasında gönderen, konu veya tarih gibi çeşitli filtreleri kullanarak belirli e-postaları bulun.
- 2E-posta klasörlerini düzenlemeMesajları farklı klasörler arasında taşıyın, etiketleri veya bayrakları yönetin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
SecureMessage Mail MCP araçları 24
README dosyasından algılandımail_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 | — |
24 aracın tümünü gösterDaha az araç göster
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 | — |
Yapılandırma
MAIL_MCP_CONFIG
| Ad | Açıklama | Sunucu |
|---|---|---|
| MAIL_MCP_CONFIG | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirsecuremessage/mail-mcp is public and reachablegithub.com/securemessage/mail-mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)BSD-2-Clausespdx.org/licenses/BSD-2-Clause.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-07github.com/securemessage/mail-mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok24 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
SecureMessage 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 soruları
SecureMessage Mail MCP hangi araçları sunar?
24 araç sunar; bunlar arasında mail_connect, mail_disconnect, mail_connection_status, mail_list_mailboxes, mail_open_mailbox yer alır.
Hangi kimlik doğrulama yöntemleri destekleniyor?
Sunucu, standart parola kimlik doğrulamasını ve Gmail, Microsoft 365 ile Yahoo gibi sağlayıcılar için OAuth/XOAUTH2 yöntemlerini destekler.
Node.js veya Composer gibi harici bağımlılıklar gerekiyor mu?
Hayır, saf PHP socket istemcilerini kullanır; PHP 8.4 ve belirli standart eklentiler dışında harici bir bağımlılığa ihtiyaç duymaz.
Aynı anda birden fazla e-posta hesabını yönetebilir miyim?
Evet, sunucu çoklu hesap yönetimini destekler ve çalışma zamanında hesaplar arasında geçiş yapmanıza olanak tanır.