
imdinu/apple-mail-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
imdinu/apple-mail-mcp - кандидат на сервер MCP, импортированный из https://github.com/imdinu/apple-mail-mcp.
Обзор
imdinu/apple-mail-mcp - кандидат на сервер MCP, импортированный из https://github.com/imdinu/apple-mail-mcp.
Обзор (машинный перевод)
Единственный MCP-сервер Apple Mail с ** полным поиском тела** — надежный на больших почтовых ящиках, где тайм-аут серверов на основе AppleScript. 8 инструментов для чтения, поиска и извлечения содержимого электронной почты.
Читайте документы для полного руководства.
Быстрый старт
###Клод Код (плагин)
Claude Desktop (комплект из одного клика)
Скачать apple-mail-mcp- .mcpb из
Последний выпуск
и дважды щелкните его.
И плагин, и пакет запускают выпущенный пакет PyPI через тонкий
пусковая установка (uvx → pipx → private venv, в зависимости от того, что доступно) — нет
продаваемый код, идентичный поведению ручной установки. Они начинают
сервер с --watch; предоставить полный доступ к диску
(Claude Code/Claude Desktop), так что индекс остается свежим.
###Любой клиент MCP
Добавьте в свой MCP клиент:
###Построение поискового индекса (рекомендуется)
Конфигурация (необязательно)
Написывает комментируемый файл конфигурации, который вы можете редактировать, чтобы устанавливать по умолчанию, как ваш
основной аккаунт или почтовый ящик. Каждый ключ имеет соответствующий APPLE_MAIL_* env
Если вы предпочитаете конфигурацию на основе окружающей среды. Видишь?
конфигурация
Полная схема и правила приоритета.
Инструменты
| Инструмент | Цель [скрыто] [скрыто] [скрыто] [скрыто] [[Т3]] | Список почтовых аккаунтов
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
Apple Mail MCP
The only Apple Mail MCP server with full-coverage body search — reliable on large mailboxes where AppleScript-based servers timeout. 8 tools for reading, searching, and extracting email content.
Read the docs for the full guide.
Quick Start
Claude Code (plugin)
claude plugin marketplace add imdinu/apple-mail-mcp
claude plugin install apple-mail@imdinu
Claude Desktop (one-click bundle)
Download apple-mail-mcp-.mcpb from the
latest release
and double-click it.
Both the plugin and the bundle run the released PyPI package via a thin
launcher (uvx → pipx → private venv, whichever is available) — no
vendored code, identical behavior to a manual install. They start the
server with --watch; grant Full Disk Access to the launching app
(Claude Code / Claude Desktop) so the index stays fresh.
Any MCP client
pipx install apple-mail-mcp
Add to your MCP client:
{
"mcpServers": {
"mail": {
"command": "apple-mail-mcp"
}
}
}
Build the Search Index (Recommended)
# Requires Full Disk Access for Terminal
# System Settings → Privacy & Security → Full Disk Access → Add Terminal
apple-mail-mcp index --verbose
Configure (Optional)
apple-mail-mcp init # writes ~/.apple-mail-mcp/config.toml
Writes a commented config file you can edit to set defaults like your
primary account or mailbox. Every key has a matching APPLE_MAIL_* env
var if you prefer environment-based config. See
Configuration
for the full schema and precedence rules.
Tools
| Tool | Purpose |
|---|---|
list_accounts() |
List email accounts |
list_mailboxes(account?) |
List mailboxes |
get_emails(filter?, limit?) |
Get emails — all, unread, flagged, today, last_7_days |
get_email(message_id) |
Get single email with full content + attachments |
Установка
This server does not publish a one-line install command.
Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →Конфигурация
{
"mcpServers": {
"mail": {
"command": "apple-mail-mcp"
}
}
}