Apple Mail MCP

Name: Apple Mail MCP
Author: parasxos

제작자: parasxos버전 1.8.3i★ –i내 컴퓨터에서 실행

레지스트리 이름io.github.parasxos/apple-mail-mcp

설치

개요

제작자가 쓴 설명(영어 원문)

Fast local Apple Mail MCP: indexed search, full-text bodies, verified sends, triage. macOS.

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

사용자 의견i아직 리뷰가 없어요리뷰는 다음 단계에서 계정 기능과 함께 열려요
우리의 기본 점검i1개 중 1개 통과공개된 정보로 점검했으며, 코드는 아직 스캔하지 않았어요
사용 정도i아주 새로움↓ 70/주 · ★ –

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

연결 방식: 내 컴퓨터에서 실행
전송 방식: stdio
카테고리: 검색 및 AI 기억

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

기본 점검: 1개 중 1개 통과
내 컴퓨터에서 내 사용자 계정의 권한(파일, 네트워크, 앱)으로 실행돼요.
레지스트리에 입력해야 할 키가 나와 있지 않아요.

필요한 것

PyPIPython의 uv 설치(uvx 명령어용)

어떤 앱을 쓰세요?

ClaudeClaude CodeCursorVS CodeChatGPT

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요

{
  "mcpServers": {
    "apple-mail": {
      "command": "uvx",
      "args": [
        "apple-mailbox-mcp"
      ]
    }
  }
}

터미널에서 이 명령어를 실행하세요

claude mcp add apple-mail -- uvx apple-mailbox-mcp

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

{
  "mcpServers": {
    "apple-mail": {
      "command": "uvx",
      "args": [
        "apple-mailbox-mcp"
      ]
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

{
  "servers": {
    "apple-mail": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "apple-mailbox-mcp"
      ]
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 8일 점검

✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 parasxos 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
… 아직 점검 안 함
계속 관리되고 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
… 아직 점검 안 함
라이선스 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
– 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
– 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
… 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

검색 및 AI 기억 카테고리의 다른 서버와 비교i

이 카테고리의 다른 서버 5692개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 5692개 중 67%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 5692개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Apple Mail MCP, 안전한가요?

해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(1.8.3)은 21일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Python (uv)도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Context7, Codebase Memory, Exa

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Context7

Up-to-date docs for AI agents

제작자: upstash널리 사용됨↓ 97.3만/주★ 6.4만그저께 업데이트

컴퓨터 또는 클라우드

설치

Codebase Memory

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

제작자: DeusData널리 사용됨↓ 1.8만/주★ 4.8만22일 전 업데이트

내 컴퓨터에서 실행

설치

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

제작자: exa-labs성장 중★ 5.2천2개월 전 업데이트

클라우드에서 실행✓ exa.ai

설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

✉️ apple-mail-mcp

Your Apple Mail, fully agent-operable.

Runs locally on your Mac. It opens the Mail store read-only, returns only what a client asks for, and sends only when the client explicitly calls the send tool. No third-party relay, no cloud copy of your mail.

uvx apple-mailbox-mcp setup

Measured on a 300k-message store: addressing one message 0.1 ms via Mail's own index, against 7 to 10 s for the AppleScript whose-clause; full-text search p95 under 1 ms. Method and script: docs/benchmarks.md.

Use Claude Code, Claude Desktop, Codex, Cursor, VS Code, or any local MCP client to search, read, triage, and send email through Apple Mail — your mailbox becomes something you can ask, search and delegate to — find anything in seconds, file hundreds of messages through a reviewed plan, send polished mail as the right identity, and let Exchange deliver scheduled messages even while your Mac is asleep.

✨ What you can do

🔍 Ask your mailbox questions. *"What did Maria send me about the memo last week?"* Search runs at database speed — sender, mailbox, dates, unread, attachments — and reconstructs whole conversations.

🕳️ Find what Mail itself can't. Mail's built-in search only skims the first line of most messages. apple-mail-mcp indexes every message body on your Mac — and for Exchange accounts it even fetches the bodies Mail never downloaded, straight from your own mailbox on the server. Queries that returned nothing return twenty.

🎭 Send as the right you. Work mail through the work lane, personal through Gmail — one parameter picks the identity. Every message is composed from scratch as clean, standards-correct email that renders everywhere, *including Outlook* (the AppleScript compose path that arrives blank in Outlook is the reason this project exists).

⏰ Schedule like "Send Later", but scriptable. A scheduled message is frozen in full — attachments, identity, exact text, and since 1.8.2 the threading headers, so a scheduled reply lands in the conversation it answers. Exchange can execute it server-side at the requested time, lid closed; other providers use a local background sender and deliver on its next pass (or just after the Mac wakes).

🗂️ Triage at scale, without fear. *"File these 40 newsletters"* becomes a reviewable plan: nothing moves until it is approved, every message is re-checked before it is touched, and the result is verified against Mail's own records afterward. Delete means Mail's Trash — nothing is ever erased.

📝 Draft where your drafts live. Compose into your real Exchange Drafts folder, ready to open in Outlook or OWA — created, never auto-sent.

⚡ Why it's different

Every other Apple-Mail MCP drives AppleScript for both finding and acting. This one doesn't — and it shows:

Operation	AppleScript whose-clause	apple-mailbox-mcp
🔍 Search 300k messages	seconds-to-timeout	milliseconds
🎯 Address one message in a 71k mailbox	7–10 s (measured)	< 0.1 ms
✉️ Send mail	body renders blank in Outlook	renders everywhere, plain+HTML
⏰ Schedule mail	—	server-side on Exchange; reliable local queue everywhere else
🗂️ Bulk triage	one call per message, fire-and-forget	one reviewed plan, one apply, verified

Every number above was measured on a live ~300,000-message store; the script and full method are in docs/benchmarks.md.

If the benchmarks hold up on your mailbox, a ⭐ helps others find this.

🛡️ Built to be trusted

✅ Plan → review → apply → verify. Bulk actions are frozen into a plan you can read before anything happens; the outcome is confirmed against Mail's own store afterward — never assumed.
🗑️ Nothing is ever erased. "Delete" files into Mail's Trash, and destructive plans have their own separate, capped door.
👓 Read-only mail mode. Set EMAIL_MCP_READ_ONLY=1 and only the 11 non-mutating mail tools exist in the session. Search may still maintain its local body index, and attachment retrieval writes the requested file to the configured temporary directory.
💾 A crash-safe scheduled queue. Manifest updates are flushed and atomically replaced, so an interrupted rewrite keeps the last valid record. If a file is damaged independently, diagnostics name it instead of claiming the queue is empty, while healthy scheduled messages keep moving.
🧾 A local, best-effort activity ledger. Sends, schedules, cancellations and triage runs are recorded without making an unwritable log block mail. For reconciliation, the message itself, its Message-ID and its scheduled record remain authoritative.
🔒 No third-party mail relay. Mail content stays local except for mail you send and optional access to your own provider for Exchange/IMAP body backfill, drafts and server-side scheduling. SMTP passwords stay in the macOS Keychain or 1Password; Microsoft OAuth tokens live in a private 0600 cache under ~/.email-mcp/graph/.
📜 A written contract. Since v1.0 every tool's shapes, error codes and caps evolve additively, held in place by 800+ automated tests.
🤝 Clear to every MCP client. All 21 tools identify what they do, explain every input, and declare whether they read, change or can remove data. Newer clients receive structured results; older clients keep the same JSON text. MCP SDK 2.2 and newer 2.x releases are tested, with support for older clients.
🧱 Built to evolve without breaking your workflow. Email rules are isolated from MCP, Mail.app, Exchange, delivery, and local storage. Provider or SDK changes stay at the edge while the 21-tool contract remains stable. The dependency rules are enforced in CI and explained in the architecture guide.
📦 Releases you can verify. Every tagged release is built and installed in a clean environment before publishing. GitHub includes the wheel, source archive, SHA-256 checksums and signed build provenance—not just source code.
🩺 Self-diagnosing. apple-mail-mcp status gives one readable readiness, scheduling and recovery screen. apple-mail-mcp doctor provides the complete diagnostic detail and an exact fix for anything red.

🚀 Quick start

Grant Full Disk Access to your terminal app (System Settings → Privacy & Security → Full Disk Access), then quit and reopen the terminal. This is Apple's one manual toggle — there is no pop-up for it.

Install and set up:

   uvx apple-mailbox-mcp setup     # or: pipx install apple-mailbox-mcp

or via Homebrew:

brew install parasxos/tap/apple-mail-mcp && apple-mail-mcp setup

Register with your client — one line for Claude Code:

   claude mcp add --transport stdio --scope user apple-mail -- uvx apple-mailbox-mcp

or the same JSON block for Claude Desktop / Cursor / VS Code (claude_desktop_config.json / .cursor/mcp.json / .vscode/mcp.json):

"mcpServers": { "apple-mail": { "command": "uvx", "args": ["apple-mailbox-mcp"] } } }

Verify: uvx apple-mailbox-mcp status prints one readiness screen — or just ask your client to run the doctor tool; every red line comes with its exact fix. uvx apple-mailbox-mcp --version prints the installed version (apple-mailbox-mcp, apple-mail-mcp and email-mcp are three names for the same command). The first body-index build on a large mailbox runs in the background and can take a few minutes; search works immediately and completes as the index fills.

Before running setup, grant your terminal app Full Disk Access (System Settings → Privacy & Security → Full Disk Access) — that is how reading stays fast and local. There is no pop-up for this one; it is Apple's one manual toggle, and setup walks you to the exact pane if it finds it missing.

setup asks everything in plain words (bare Enter accepts the recommended answer), offers a sending identity, builds the body-search index, verifies the nightly refresh actually runs, and ends by printing the one block you paste into your MCP client:

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

Setup ends with a clear ready verdict or numbered recovery steps. Grant Automation → Mail when triage first asks for it. Check the installation, the next scheduled message, and failed scheduled sends anytime with apple-mail-mcp status; use apple-mail-mcp doctor for the full technical detail.

💡 *New to the terminal?* Three things that look wrong and aren't:

brew install pipx wants a typed y (Enter alone is rejected);

pipx ensurepath may print a ⚠️ — the "pipx is ready to go!" line after it

is the verdict; and after ensurepath, close and reopen the terminal once

so apple-mail-mcp is found.

🔌 Works with

Every client below speaks stdio MCP; the command is always uvx apple-mailbox-mcp.

Claude Code

claude mcp add --transport stdio --scope user apple-mail -- uvx apple-mailbox-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{ "mcpServers": { "apple-mail": { "command": "uvx", "args": ["apple-mailbox-mcp"] } } }

Cursor

Add the same block to ~/.cursor/mcp.json (or per-project .cursor/mcp.json).

VS Code (Copilot MCP)

Add the same block under "servers" in .vscode/mcp.json.

Codex CLI

# ~/.codex/config.toml

[mcp_servers.apple-mail] command = "uvx" args = ["apple-mailbox-mcp"]

Any stdio MCP client

Point it at uvx apple-mailbox-mcp. The wire contract is additive-only since v1.0.

🔧 Troubleshooting

Symptom	Fix
Client says the server failed to start, but `uvx apple-mailbox-mcp` works in your terminal	GUI apps don't inherit your shell PATH. Use the absolute path: `"command": "/opt/homebrew/bin/uvx"` (find yours with `which uvx`).
`database is locked` or empty results	Full Disk Access is missing for the app that launches the server (the client, not the terminal). Grant it, then fully quit and reopen that app.
Search finds recent mail but not bodies of old mail	The body index is still building — first build on a 100k+ mailbox takes minutes. `status` shows progress.
Send fails with `transport_unavailable`	Run `doctor`: it names the failing lane (Keychain item missing, SSH socket cold, SMTP host unreachable) and prints the exact fix.
Triage does nothing the first time	Grant Automation → Mail when macOS asks; the prompt appears on first use, not at install.

🧰 The 21 tools

Group	Tools
🔍 Read (8)	`search_emails` (full-body search) · `get_email` · `get_emails_batch` · `get_thread` · `list_mailboxes` · `list_recent` · `get_attachment` · `refresh_mail`
✉️ Send (6)	`send_email` · `reply_email` (threaded, quoted) · `create_draft` · `schedule_email` (threaded on request) · `list_scheduled` · `cancel_scheduled`
🗂️ Triage (5)	`triage_plan` · `triage_plan_delete` · `triage_apply` · `mailbox_create` · `mailbox_delete`

| 🩺 Meta (2) | doctor

앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요

Apple Mail MCP

개요

PopNx MCP의 세 기둥

할 수 있는 일

설치

설치하기 전에

할 수 있는 일

기본 점검i

제작자와 저장소 일치

계속 관리되고 있음

라이선스 있음

엔드포인트 응답

OAuth로 로그인

도구 설명에 숨겨진 지시 없음

검색 및 AI 기억 카테고리의 다른 서버와 비교i

자주 묻는 질문

대안

Context7

Codebase Memory

Exa

제작자의 README

✉️ apple-mail-mcp

Your Apple Mail, fully agent-operable.

✨ What you can do

⚡ Why it's different

🛡️ Built to be trusted

🚀 Quick start

or via Homebrew:

🔌 Works with

Claude Code

Claude Desktop

Cursor

VS Code (Copilot MCP)

Codex CLI

Any stdio MCP client

🔧 Troubleshooting

🧰 The 21 tools