SecureMessage Mail MCP server
Commit 7 Nov 2026Memungkinkan AI client untuk mengelola akun email melalui IMAP dan SMTP, termasuk mencari, membaca, mengirim, dan mengatur pesan.
Juga dikenal sebagai securemessage/mail-mcp
- Stars
- 1
- Tools
- 24
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 7 Nov 2026
- Lisensi
- BSD-2-Clause
Apa itu SecureMessage Mail MCP?
Memungkinkan AI client untuk mengelola akun email melalui IMAP dan SMTP, termasuk mencari, membaca, mengirim, dan mengatur pesan. Server ini menyediakan 24 tool, seperti mail_connect, mail_disconnect, mail_connection_status.
Ringkasan dibuat dari README proyek
Tentang SecureMessage Mail MCP server
Mengelola akun email secara langsung dari AI client adalah fungsi utama yang disediakan oleh MCP server berbasis PHP ini. Tool ini memungkinkan developer dan pengguna untuk mencari, membaca, mengirim, dan mengatur pesan menggunakan protokol IMAP dan SMTP. Server ini mendukung banyak akun yang dapat diganti saat runtime dan bekerja dengan provider seperti Gmail, Microsoft 365, dan Yahoo melalui autentikasi XOAUTH2.
Berjalan di atas PHP 8.4, server ini didistribusikan sebagai file PHAR tunggal yang tidak memerlukan dependensi eksternal seperti Node.js atau Composer. Tersedia 22 tool spesifik, termasuk mail_search dengan lebih dari 12 parameter filter, mail_get_thread untuk riwayat percakapan, dan mail_create_draft untuk menyiapkan pesan. Anda dapat mengintegrasikannya ke Claude Desktop atau Windsurf dengan mengonfigurasi command untuk menjalankan file PHAR tersebut.
Tool ini unik karena menggunakan pure PHP socket clients alih-alih mengandalkan ekstensi ext-imap. Ia mampu menangani tugas kompleks seperti memindahkan pesan antar folder, mengelola flag, dan mengambil lampiran. Tool ini dirancang untuk deployment lokal di mana AI agent dapat berinteraksi dengan berbagai mailbox melalui interface yang terpadu.
Apa yang bisa Anda lakukan dengannya
- 1Mencari di berbagai mailboxTemukan email spesifik menggunakan berbagai filter seperti pengirim, subjek, atau tanggal di seluruh folder.
- 2Mengatur folder emailPindahkan pesan di antara folder yang berbeda dan kelola label atau flag.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Tool SecureMessage Mail MCP 24
Terdeteksi dari 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 | — |
Tampilkan semua 24 toolTampilkan lebih sedikit tool
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 | — |
Konfigurasi
MAIL_MCP_CONFIG
| Nama | Deskripsi | Tipe |
|---|---|---|
| MAIL_MCP_CONFIG | — |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkausecuremessage/mail-mcp is public and reachablegithub.com/securemessage/mail-mcp ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)BSD-2-Clausespdx.org/licenses/BSD-2-Clause.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-07github.com/securemessage/mail-mcp ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model24 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelNo tool named like delete, drop or execLolos
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di 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.
Pertanyaan tentang SecureMessage Mail MCP
Tool apa yang disediakan SecureMessage Mail MCP?
Server ini menyediakan 24 tool, termasuk mail_connect, mail_disconnect, mail_connection_status, mail_list_mailboxes, mail_open_mailbox.
Metode autentikasi apa saja yang didukung?
Server ini mendukung autentikasi password standar dan OAuth/XOAUTH2 untuk provider seperti Gmail, Microsoft 365, dan Yahoo.
Apakah ini memerlukan dependensi eksternal seperti Node.js atau Composer?
Tidak, server ini menggunakan pure PHP socket clients dan tidak memerlukan dependensi eksternal selain PHP 8.4 dan ekstensi standar tertentu.
Bisakah saya mengelola beberapa akun email sekaligus?
Ya, server ini mendukung manajemen multi-account dan memungkinkan Anda untuk berpindah antar akun saat runtime.