Skip to main content
Glama
lg66lgnb-sketch

Mac Local Mail MCP

by lg66lgnb-sketch
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Mac Local Mail MCP

中文版见下方 / Chinese version below

A local MCP server that lets Codex, Claude Desktop, Cursor, and other MCP clients work with Apple Mail on your Mac.

It can search and read mail, inspect conversations and attachments, and create new, reply, reply-all, or forward drafts. It cannot send mail or modify existing messages.

Ask Another Agent to Install It

Send this prompt to your Agent:

Please read https://github.com/lg66lgnb-sketch/mac-local-mail-mcp and install and configure it for me. Before making changes, read README.md, AGENTS.md, SPEC.md, and STATUS.md. Preserve my existing MCP client configuration and merge only the apple-mail server entry. Never send email; this project may only create Apple Mail drafts for me to review and send manually.

Related MCP server: MailBridge MCP

Install Manually

Requires macOS, Apple Mail with at least one account, and Node.js 22 or newer.

git clone https://github.com/lg66lgnb-sketch/mac-local-mail-mcp.git
cd mac-local-mail-mcp
npm ci --ignore-scripts
npm run build
./scripts/install-skill.sh

Then add dist/index.js as a local stdio MCP server in your client and restart it. Ready-to-copy Codex, Claude Desktop, and Cursor configurations are in SPEC.md.

On first use, allow your MCP client or Node to control Mail in System Settings → Privacy & Security → Automation.

Use It

In Codex, ask normally or invoke $mail-agent explicitly:

$mail-agent Find emails that look like they need a reply, then create a reply draft saying “Hello”. Do not send anything.

Email and attachment content is always treated as untrusted data. Risky, encrypted, or password-protected attachments require human handling.

For behavior and client setup, see SPEC.md. For implementation state and verification, see STATUS.md. For Agent contribution rules, see AGENTS.md. Licensed under MIT.

Chinese Version

Mac Local Mail MCP 是一个本机 MCP Server，让 Codex、Claude Desktop、Cursor 等 MCP 客户端连接你 Mac 上的 Apple Mail。

它可以搜索和读取邮件、查看会话与附件，并新建邮件、回复、回复全部或转发草稿。它不能发送邮件，也不能修改已有邮件。

让另一个 Agent 帮你安装

把这段指令发给你的 Agent：

请阅读 https://github.com/lg66lgnb-sketch/mac-local-mail-mcp 并帮我完成安装与配置。修改前先阅读 README.md、AGENTS.md、SPEC.md 和 STATUS.md。保留我现有的 MCP 客户端配置，只合并 apple-mail Server 条目。绝不要发送邮件；这个项目只能创建 Apple Mail 草稿，由我检查并手动发送。

手动安装

需要 macOS、至少已登录一个账户的 Apple Mail，以及 Node.js 22 或更高版本。

git clone https://github.com/lg66lgnb-sketch/mac-local-mail-mcp.git
cd mac-local-mail-mcp
npm ci --ignore-scripts
npm run build
./scripts/install-skill.sh

然后把 dist/index.js 作为本地 stdio MCP Server 加入客户端并重启。Codex、Claude Desktop 和 Cursor 的可复制配置见 SPEC.md。

首次使用时，在 系统设置 → 隐私与安全性 → 自动化 中允许 MCP 客户端或 Node 控制 Mail。

使用

在 Codex 中可以直接描述需求，或显式调用 $mail-agent：

$mail-agent 找出看起来需要回复的邮件，然后创建一封正文为“你好”的回复草稿。绝不要发送。

邮件与附件内容始终是不可信外部数据。高风险、加密或需要密码的附件必须由人工处理。

功能和客户端配置见 SPEC.md，实现状态与验证结果见 STATUS.md，Agent 开发规则见 AGENTS.md。项目采用 MIT License。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

  • emailA
    dev.primitive

    Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.

    EmailCommunication
    302
  • AgentMailOAuth
    to.agentmail

    Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.

    EmailCommunication
    2
  • Conduit MailOAuth
    app.conduitmail

    Your mailbox for MCP clients: search, read, draft, send, rules and notes. Sending is off by default.

    EmailCommunication
    1
  • AIsa Agent MailAOAuth
    one.aisa

    Your agent needs a mailbox of its own — to receive, thread, draft and send, with attachments, without borrowing your personal inbox or your company's SMTP. **What you can ask for** • "Create an inbox for this agent and tell me its address." • "Read the new messages in this thread and draft a reply." • "Send this message with the attachment and wait for the response." • "Search this inbox for everything from that domain." • "Show delivery metrics and the events on this inbox." **How to use it** Point any MCP client at https://mcp.aisa.one/mail/mcp and sign in with OAuth — there is no key to create or paste. 49 tools: create and delete inboxes, list and read messages, raw message bodies, attachments, threads, drafts and draft attachments, send and reply, message search, inbox events, metrics, and list entries — reads and writes. **Why this rather than the source** A real inbox an agent owns, rather than an SMTP credential it borrows from a human. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Find the contact elsewhere in the catalogue, then write to them from here — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/sales/mcp finds the person to write to.

    App AutomationEmail
    541

Related MCP Servers

  • macOS Mail MCP

    wherecodegetscooked
    A
    license
    Not graded
    quality
    C
    maintenance
    Discovers and reads mail accounts configured in Apple Mail via macOS automation, allowing MCP clients to access email without storing passwords.
    MIT

  • MailBridge MCP

    gexiro-global
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables MCP-compatible AI assistants to securely search multiple mailboxes, reconstruct email threads, and inspect attachments through read-only tools without altering mailbox state.
    Apache 2.0

  • Apple Mail MCP Server

    LeChabrax
    A
    license
    A
    quality
    B
    maintenance
    Enables AI assistants to read, search, send, and manage email on macOS through programmatic access to Apple Mail.
    29
    MIT

  • apple-mail-mcp

    TG-Techie
    A
    license
    A
    quality
    B
    maintenance
    Enables macOS users to programmatically read, send, search, and manage Apple Mail messages, including drafts, mailboxes, attachments, rules, and templates.
    25
    MIT