Skip to content
MCP server

Apple Mail

Search, read, draft and send mail through Apple Mail on macOS, with safety profiles

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, CLI
Runs
Locally
Version
1.1.7
Listing updated
today

Similar MCP servers

About Apple Mail

Apple Mail is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

Apple Mail MCP drives the native Mail app so an agent can list mailboxes, search and read messages and threads, create drafts, reply, forward, mark, move, delete and archive. Mail stays the system of record.

Three profiles control risk: safe_readonly, safe_manage (the default for uvx and clone installs, which saves replies and forwards as unsent drafts and sends nothing) and full_access, which can send. The Claude Desktop bundle defaults to full_access. Deleting or archiving works in safe_manage, and blocked tools return an error naming the setting to change.

It runs locally over stdio via uvx apple-mcp-mail, with health and permission-check tools.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "apple-mcp-mail": {
      "command": "uvx",
      "args": [
        "apple-mcp-mail"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "apple-mcp-mail": {
      "command": "uvx",
      "args": [
        "apple-mcp-mail"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • APPLE_MAIL_MCP_SAFETY_PROFILESafety mode for Mail operations: safe_readonly, safe_manage, or full_access.
  • APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOTDirectory attachments may be saved to or attached from. Unset disables attachment file access.
  • APPLE_MAIL_MCP_VISIBLE_DRAFTSWhether drafts stay open in a Mail window. false saves them to the Drafts mailbox and leaves no window open.

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

mail_health
Checks health.
mail_list_mailboxes
Lists mailboxes.
mail_search_messages
Searches messages.
mail_get_message
Gets a message.
mail_get_thread
Gets a thread.
mail_compose_draft
Composes a draft.
mail_send_message
Sends a message.
mail_reply_message
Replies to a message.
mail_forward_message
Forwards a message.
mail_move_message
Moves a message.
mail_delete_message
Deletes a message.
mail_archive_thread
Archives a thread.

What it does

Mailbox search
Search and read messages.
Thread helpers
Get, reply to and archive threads.
Draft first
safe_manage saves drafts instead of sending.
Full access
Optionally send directly.
Visible drafts
Option to open drafts in Mail.
Permission tools
Health and recovery helpers.

Good for

  • Draft replies for review
  • Find a message in a thread
  • Archive a thread
  • Triage unread mail

Pricing

Open source

Free; runs locally

Apple Mail FAQ

Does it send mail by default?

Not in safe_manage; send needs full_access.

Install?

uvx apple-mcp-mail.

Bundle default?

full_access.

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 apple-mcp-mail -- uvx apple-mcp-mail

What are the best alternatives to Apple Mail?

The closest alternatives to Apple Mail are TrendRadar, Ha MCP, Concord MCP, Getmitra and note1.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers