IA

imdinu/apple-mail-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

73 stars 31 forks Качество 84 Тренд 34GPL-3.0

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"
    }
  }
}
# 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
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "mail": { "command": "apple-mail-mcp" } } }