苹果邮件MCP
     
唯一具有以下功能的Apple Mail MCP服务器 全文电子邮件搜索。在其他服务器超时的大型邮箱上可靠——有8个工具用于读取、搜索和提取电子邮件内容。
阅读文档 完整的指南。
快速开始
pipx install apple-mail-mcp添加到您的MCP客户端：
{
"mcpServers": {
"mail": {
"command": "apple-mail-mcp"
}
}
}构建搜索索引（推荐）
# Requires Full Disk Access for Terminal
# System Settings → Privacy & Security → Full Disk Access → Add Terminal
apple-mail-mcp index --verbose工具
| 工具 | 目的 |
|---|---|
list_accounts() | 列出电子邮件帐户 |
list_mailboxes(account?) | 列出邮箱 |
get_emails(filter?, limit?) | 获取电子邮件--全部、未读、已标记、今天、最近7天 |
get_email(message_id) | 获取包含完整内容和附件的单封电子邮件 |
search(query, scope?, before?, after?, highlight?) | 搜索--全部、主题、发件人、正文、附件 |
get_email_links(message_id) | 从电子邮件中提取链接 |
get_email_attachment(message_id, filename) | 提取附件内容 |
get_attachment(message_id, filename) | *已弃用* --使用 get_email_attachment() |
演出
经过测试 8台其他Apple Mail MCP服务器 在一个真实的 约72K条消息 邮箱：
- 只有具有全覆盖身体搜索功能的服务器。 大多数竞争对手根本不支持搜身；实时扫描的（BastianZim）只扫描了5000条最新消息，对任何旧消息都没有任何遗漏。我们的FTS5索引覆盖了整个邮箱。
- ~3ms单封电子邮件提取 先通过磁盘
.emlx阅读（无JXA往返）。 - ~7ms主题搜索 通过FTS5——在相同的操作上与原生Rust竞争。
- 在所有6个基准操作中都是可靠的 在72K邮箱上；基于AppleScript的服务器超时、抛出语法错误或跳过它们不支持的操作。
配置
| 变量 | 默认值 | 描述 |
|---|---|---|
APPLE_MAIL_DEFAULT_ACCOUNT | 第一个帐户 | 默认电子邮件帐户 |
APPLE_MAIL_DEFAULT_MAILBOX | INBOX | 默认邮箱 |
APPLE_MAIL_INDEX_PATH | ~/.apple-mail-mcp/index.db | 索引位置 |
APPLE_MAIL_INDEX_MAX_EMAILS | _取消设置_ | 可选的每个邮箱上限（默认值：无上限） |
APPLE_MAIL_INDEX_EXCLUDE_MAILBOXES | Drafts | 搜索中要跳过的邮箱 |
APPLE_MAIL_READ_ONLY | false | 禁用写入操作 |
{
"mcpServers": {
"mail": {
"command": "apple-mail-mcp",
"args": ["--watch"],
"env": {
"APPLE_MAIL_DEFAULT_ACCOUNT": "Work"
}
}
}
}CLI使用情况
所有工具都可以作为独立的CLI命令使用（不需要MCP服务器）：
apple-mail-mcp search "quarterly report" --scope subject
apple-mail-mcp search "invoice" --after 2026-01-01 --limit 10
apple-mail-mcp read 12345
apple-mail-mcp emails --filter unread --limit 10
apple-mail-mcp accounts
apple-mail-mcp mailboxes --account Work
apple-mail-mcp extract 12345 invoice.pdf所有命令都输出JSON。生成一个 Claude代码技能 对于基于CLI的访问：
apple-mail-mcp integrate claude > ~/.claude/skills/apple-mail.md发展
git clone https://github.com/imdinu/apple-mail-mcp
cd apple-mail-mcp
uv sync
uv run ruff check src/
uv run pytest许可证
GPL-3.0或更高版本