Skip to content
MCP server

Apple Mail, Calendar & Notes

Local server for Apple Mail, Calendar and Notes on macOS, with no dependencies

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, CLI
Runs
Locally
Version
1.6.1
Listing updated
1 day ago

About Apple Mail, Calendar & Notes

Apple Mail, Calendar & Notes is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

This server drives the Mail, Calendar and Notes apps already on your Mac, so any account Mail.app can open becomes available to an assistant, including self-hosted IMAP, iCloud, Exchange and Gmail over IMAP. It has no network code, so mail stays on the Mac unless your model runs elsewhere.

Its triage features go beyond search. It can list emails from real people you have not answered, emails you sent that nobody replied to, and whole conversations in order. Writing is cautious: replies and forwards open as drafts for you to send, dry runs show exactly what would go out, and an identical send twice within 15 minutes is refused. Mail goes to Trash and notes to Recently Deleted rather than being removed permanently.

It runs on JavaScript for Automation, so no Node or Python is needed, and groups everything into a read tool and a write tool. Setting APPLE_MAIL_READ_ONLY removes the write tool.

Install

Run in a terminal

claude mcp add apple-mail-mcp -- npx -y https://github.com/ipsupport-llc/apple-mail-mcp/releases/download/v1.6.1/apple-mail-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "apple-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ipsupport-llc/apple-mail-mcp/releases/download/v1.6.1/apple-mail-mcp.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "apple-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ipsupport-llc/apple-mail-mcp/releases/download/v1.6.1/apple-mail-mcp.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "apple-mail-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ipsupport-llc/apple-mail-mcp/releases/download/v1.6.1/apple-mail-mcp.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "apple-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ipsupport-llc/apple-mail-mcp/releases/download/v1.6.1/apple-mail-mcp.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "apple-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ipsupport-llc/apple-mail-mcp/releases/download/v1.6.1/apple-mail-mcp.mcpb"
      ]
    }
  }
}

Configuration

  • APPLE_MAIL_READ_ONLYtrue hides the write tool: read and search only
  • APPLE_MAIL_DEFAULT_ACCOUNTMail account used when none is named, e.g. Work
  • APPLE_MAIL_SAVE_DIRFolder for saved attachments (default ~/Downloads)

Tools this server provides (2)

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

read
Read and search mail, calendar and notes
write
Send, reply, forward, organise mail and create calendar events and notes

What it does

Mail triage
Finds mail needing a response and sent mail awaiting a reply.
Search and read
Search by text, sender, dates, flags and attachments.
Drafts by default
Replies and forwards open in Mail for you to send.
Folders and rules
Create folders and Mail rules, and move or flag messages with dry runs.
Calendar
See events across calendars, and create or delete them.
Notes
Browse, search, create, append and delete notes.

Good for

  • Ask what email is waiting for your reply
  • Forward an invoice to accounting as a draft
  • Schedule a call on your calendar
  • Save attachments from a contract email
  • Append meeting notes to an Apple Note

Pricing

Open source

Apple Mail, Calendar & Notes FAQ

What does it need?

macOS 14 or later and an MCP client; macOS asks you to allow automation the first time.

Can I prevent it from sending mail?

Yes, set APPLE_MAIL_READ_ONLY=true to remove the write tool.

Is anything deleted permanently?

No. Mail goes to the account's Trash and notes go to Recently Deleted.

Does it send my mail over the network?

The server has no network code; where data goes next depends on your model.

Is Apple Mail, Calendar & Notes free?

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

How do I add Apple Mail, Calendar & Notes to Claude Code?

Run this command in your terminal: claude mcp add apple-mail-mcp -- npx -y https://github.com/ipsupport-llc/apple-mail-mcp/releases/download/v1.6.1/apple-mail-mcp.mcpb

What are the best alternatives to Apple Mail, Calendar & Notes?

The closest alternatives to Apple Mail, Calendar & Notes are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

Alternatives to Apple Mail, Calendar & Notes

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools