psychquant/che-apple-mail-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
Apple Mail MCP server — 53 tools with SQLite-powered millisecond search across 250K+ emails, .emlx parser, batch markdown export, and composing that never injects a message body through AppleScript...
概要
- 54 tools with SQLite-powered millisecond search across 250K+ emails. Install the . It brings the signed binary, the /archive-mail command family, the safety rules, and the staleness hook as one unit: Then grant permissions — the setup window shows live status and links straight to the right System Settings pane: is what makes the fast SQLite read path and batch_export_emails_markdown work. Without it the tools still run but read little or nothing, which is easy to mistake for a bug rather than a permission. macOS does not let an app request FDA programmatically — it has to be ticked by hand — which is exactly what the setup window is there to make quick. Registering the MCP server by itself is a supported advanced path, but it is a install. Choose it knowingly — nothing at runtime will tell you these are missing (#353): Advanced: register the MCP server only (development, or you want no plugin) Install the binary to a local directory like ~/bin/.
README
以下は原文 README の抜粋です。原文を見る。
che-apple-mail-mcp
The most comprehensive Apple Mail MCP server - 59 tools with SQLite-powered millisecond search across 250K+ emails.
Why che-apple-mail-mcp?
| Feature | Other MCPs | che-apple-mail-mcp |
|---|---|---|
| Total Tools | ~20 | 59 |
| Language | Python | Swift (Native) |
| Search Speed | Seconds (AppleScript) | Milliseconds (SQLite) |
| Search Fields | Subject/Sender | Subject/Sender/Recipient/Date |
| Batch Operations | No | Up to 50 emails per call |
| Mailbox Management | Basic | Full CRUD |
| Email Colors | No | 7 flag colors + background |
| VIP Management | No | Yes |
| Rule Management | Partial | Full CRUD |
| Signatures | No | Yes |
| Raw Headers/Source | No | Yes |
Quick Start
Install the plugin. It brings the signed binary, the /archive-mail command
family, the safety rules, and the staleness hook as one unit:
claude plugin marketplace add PsychQuant/che-apple-mail-mcp
claude plugin install che-apple-mail-mcp@che-apple-mail-mcp
Maintainers can run make check-install to verify that these documented public GitHub
marketplaces still list the requested plugins. The Install instructions CI
runs on pull requests, pushes to main, and daily. PR checks use the checkout
manifest only for this repository (--checkout-repo), while external sources
are always fetched remotely; main/scheduled/manual checks inspect published
remote manifests. Thus a coordinated local rename can pass PR review, and changes in an external
marketplace can also be detected. A missing entry or invalid source fails with
INSTALL_RESOLUTION_INVALID (exit 1); bounded network failures report
INSTALL_RESOLUTION_UNCERTAIN (exit 2), also a failing check. Neither is silently
skipped. Unrelated entry metadata is ignored; an unreadable entry name prevents
a definite absence claim when the requested target was not otherwise found.
This checks remote marketplace membership; it does not execute or verify
the Claude loader, download the plugin, or install anything. Offline regression
fixtures run with make test-plugin. The resolver accepts fenced shell commands
using owner/repo or GitHub HTTPS repository sources and plugin@marketplace
install targets; recognized installation-looking commands in unsupported forms
(including wrappers or global options) fail explicitly, as do such commands in
unsupported fence languages or outside a supported fence. Shell continuations
インストール
This server does not publish a one-line install command.
Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →設定
{
"mcpServers": {
"che-apple-mail-mcp": {
"command": "/full/path/to/che-apple-mail-mcp/.build/release/CheAppleMailMCP"
}
}
}