# Apple Mail

> Apple Mail is an open-source MCP server for communication. Local MCP server for searching and reading Apple Mail with account-scoped access. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Website:** https://cupertino.mgcrea.io
- **Repository:** https://github.com/mgcrea/cupertino/tree/HEAD/packages/mail
- **MCP Registry name:** io.github.mgcrea/mcp-apple-mail
- **Categories:** communication, productivity
- **Listing updated:** 2026-11-14

## About

Mail is where the Cupertino servers lean hardest on speed. The README reports measurements from a 29,617-message mailbox and uses a read-only index for search and body reading, because asking Mail.app the same question over Apple Events can take over a minute. Apple Events remain for accounts, mailboxes and every change.

Three environment variables define the safety model. `APPLE_MAIL_ACCOUNTS` limits both reads and writes to named accounts, `APPLE_MAIL_ALLOW_WRITES` registers the mutating tools, and `APPLE_MAIL_ALLOW_FILE_SEND` separately allows a compose call to attach a local file and send in one step, since that skips human review.

It needs Automation permission for Mail. Full Disk Access unlocks search, message bodies and attachments; without it the server still lists accounts, mailboxes and counts. The README explains why that grant is better held by a dedicated menu-bar app than by an editor. It is unofficial and not affiliated with Apple.

## Features

- **Threaded search:** Finds messages and reads whole threads from mail already synced to the Mac.
- **Body search:** Searches message bodies and reads attachments when Full Disk Access is granted.
- **Account scoping:** APPLE_MAIL_ACCOUNTS bounds what can be read as well as written.
- **Gated sending:** File attach-and-send needs its own opt-in flag, apart from general writes.
- **No mail credentials:** Uses Mail already on the Mac, with no IMAP login or OAuth.

## Good for

- Find unread mail from one sender this quarter
- Pull a full thread to draft a reply in your voice
- Limit an agent to the work account only
- Gather everything about a project from mail, notes and calendar

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-apple-mail -- npx -y @mgcrea/mcp-apple-mail
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-apple-mail": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-mail"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-apple-mail": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-mail"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-apple-mail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-mail"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-apple-mail": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-mail"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-apple-mail": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-mail"
      ]
    }
  }
}
```

## Tools

- `apple_mail_search_messages`: Searches Mail messages
- `apple_mail_get_thread`: Reads a mail thread

## FAQ

### Does it need my IMAP password?

No. It reads mail already synced to your Mac.

### What breaks without Full Disk Access?

Search, bodies and attachments are unavailable; accounts, mailboxes and counts still work.

### Can it send email?

Only when writes are enabled, and attaching a file while sending needs APPLE_MAIL_ALLOW_FILE_SEND.

### Is it official?

No, it is unofficial and not affiliated with Apple.

### Is Apple Mail free?

Yes. Apple Mail is open source, so you can use and self-host it for free.

### How do I add Apple Mail to Claude Code?

Run this command in your terminal: claude mcp add mcp-apple-mail -- npx -y @mgcrea/mcp-apple-mail

### What are the best alternatives to Apple Mail?

The closest alternatives to Apple Mail are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/apple-mail-2
