SecureMessage Mail MCP server
2026년 11월 7일 커밋IMAP 및 SMTP를 통해 AI 클라이언트가 이메일 계정을 관리할 수 있도록 하며, 메시지 검색, 읽기, 보내기 및 정리 기능을 제공합니다.
다른 이름 securemessage/mail-mcp
- 스타
- 1
- Tools
- 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 및 특정 표준 확장 기능 외에 별도의 외부 의존성이 필요하지 않습니다.
여러 이메일 계정을 동시에 관리할 수 있나요?
네, 이 서버는 멀티 계정 관리를 지원하며 런타임 중에 계정을 전환할 수 있습니다.