SecureMessage Mail MCPサーバー
コミット 2026年11月7日IMAPおよびSMTPを介して、メールの検索、閲覧、送信、整理など、AIクライアントによるメールアカウント管理を可能にします。
別名 securemessage/mail-mcp
- スター
- 1
- ツール
- 24
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月7日
- ライセンス
- BSD-2-Clause
SecureMessage Mail MCPとは
IMAPおよびSMTPを介して、メールの検索、閲覧、送信、整理など、AIクライアントによるメールアカウント管理を可能にします。 24個のツールを提供しており、mail_connect, mail_disconnect, mail_connection_statusなどがあります。
プロジェクトのREADMEから生成された概要
SecureMessage Mail MCP server について
このPHPベースのサーバーは、AIクライアントから直接メールアカウントを管理することを可能にします。開発者やユーザーは、IMAPおよびSMTPプロトコルを使用して、メッセージの検索、閲覧、送信、整理を行うことができます。このサーバーは、実行時に切り替え可能な複数アカウントをサポートしており、XOAUTH2認証を通じてGmail、Microsoft 365、Yahooなどのプロバイダーに対応しています。
PHP 8.4上で動作するこのサーバーは、単一のPHARファイルとして配布されるため、Node.jsやComposerのような外部の依存関係を必要としません。12種類以上のフィルターパラメータを持つmail_search、会話履歴を取得するmail_get_thread、メッセージの下書きを作成するmail_create_draftなど、22個の特定のツールを提供します。ユーザーは、PHARファイルを実行するようにコマンドを設定することで、Claude DesktopやWindsurfに統合できます。
このツールは、ext-imap拡張機能に依存せず、純粋なPHPソケットクライアントを使用している点が特徴です。フォルダ間のメッセージ移動、フラグ管理、添付ファイルの取得といった複雑なタスクを処理します。AIエージェントが統一されたインターフェースを通じて様々なメールボックスとやり取りできる、ローカルデプロイメント向けに設計されています。
できること
- 1複数のメールボックスの検索すべてのフォルダを対象に、送信者、件名、日付などの様々なフィルターを使用して特定のメールを見つけます。
- 2メールフォルダの整理異なるフォルダ間でメッセージを移動したり、ラベルやフラグを管理したりします。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
SecureMessage Mail MCPツール 24
READMEから検出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個のツールをすべて表示ツールを折りたたむ
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 | — |
設定
MAIL_MCP_CONFIG
| 名前 | 説明 | 種類 |
|---|---|---|
| MAIL_MCP_CONFIG | — |
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能securemessage/mail-mcp is public and reachablegithub.com/securemessage/mail-mcp ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)BSD-2-Clausespdx.org/licenses/BSD-2-Clause.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-07github.com/securemessage/mail-mcp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない24 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされているNo tool named like delete, drop or exec合格
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見る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のよくある質問
SecureMessage Mail MCPが提供するツールは
24個のツールを提供しており、mail_connect, mail_disconnect, mail_connection_status, mail_list_mailboxes, mail_open_mailboxなどがあります。
どのような認証方法がサポートされていますか?
標準的なパスワード認証のほか、Gmail、Microsoft 365、Yahooなどのプロバイダー向けにOAuth/XOAUTH2をサポートしています。
Node.jsやComposerなどの外部依存関係は必要ですか?
いいえ、純粋なPHPソケットクライアントを使用しているため、PHP 8.4と特定の標準拡張機能以外に外部の依存関係は必要ありません。
複数のメールアカウントを同時に管理できますか?
はい、このサーバーはマルチアカウント管理をサポートしており、実行時にアカウントを切り替えることができます。