Skip to content
MCP server

macOS Apps

Local MCP server for Mail, Calendar, Notes and other macOS apps with previewed deletes

Runs locallyStatus and history
Install
Pricing
Free
Platforms
macOS, CLI
Runs
Locally
Version
0.15.1
Listing updated
1 day ago

About macOS Apps

macOS Apps is a free MCP server for productivity. It runs locally on your machine and is started by your AI client.

This macOS-only server reaches Mail, Calendar, Reminders, Notes, Messages, Contacts, Photos, Safari, Music and Shortcuts through one Python process (FastMCP, run with uvx). Searches return pointers: an id, a one-line summary and a link that opens the item in its app, with full bodies fetched separately and capped.

Safety is the main design theme. Tools are split into read, write and outbound tiers; send tools stay hidden until you enable them per app, and a read-only environment variable registers reads only. Deletes, moves and sends default to dry run, every write is logged to an audit file, and Mail messages are copied as .eml backups before a move so mail_undo can reverse it. The README states it makes no network requests of its own.

A doctor tool reports which macOS permissions are granted, and an optional signed daemon app can hold them for all clients.

Install

Run in a terminal

claude mcp add macos-apps-mcp -- uvx macos-apps-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "macos-apps-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "macos-apps-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "macos-apps-mcp": {
      "command": "uvx",
      "args": [
        "macos-apps-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "macos-apps-mcp": {
      "command": "uvx",
      "args": [
        "macos-apps-mcp"
      ]
    }
  }
}

Tools this server provides (12)

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

events
Lists calendar events for today, the week or a date.
free_busy
Returns merged busy intervals and free gaps.
reminders
Lists reminders due today, overdue or by list.
create_event
Creates a calendar event.
update_event
Updates a calendar event by id.
mail_search
Searches Mail and returns pointers.
mail_needs_response
Finds emails that need a reply.
mail_reply
Opens a reply as a draft in Mail.
move_mail
Moves mail, previewing by default.
mail_undo
Reverses a mail move or delete batch.
doctor
Reports which macOS permissions are granted.
audit
Reads the audit log back.

What it does

Pointer results
Searches return ids and links rather than full bodies.
Tiered writes
Read, write and outbound tools are gated separately.
Dry-run defaults
Deletes, moves and sends preview before acting.
Audit log
Every write is recorded and readable through an audit tool.
Mail backup and undo
Messages are saved as .eml before moves, and mail_undo reverses a batch.
Permission doctor
Reports EventKit, Automation and other grants without dialogs.
Adapter switches
Individual apps can be turned off to cut tool count.

Good for

  • Ask when you are free on Thursday afternoon
  • Find emails that need a reply and open a draft
  • Move newsletters to Archive after previewing
  • Review reminders due this week

Pricing

Free

Package on PyPI; no licence or price stated

macOS Apps FAQ

Which platforms work?

macOS only, with Python 3.12 or later and uv.

Does it send email by itself?

No. Send tools are off until you enable them, and mail_reply only opens a draft.

Does it phone home?

The README says no telemetry and no network requests of its own.

How do I install it?

Point your client at uvx macos-apps-mcp.

Is macOS Apps free?

Yes. macOS Apps is free to use.

How do I add macOS Apps to Claude Code?

Run this command in your terminal: claude mcp add macos-apps-mcp -- uvx macos-apps-mcp

What are the best alternatives to macOS Apps?

The closest alternatives to macOS Apps are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

Alternatives to macOS Apps

  1. 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
  2. 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
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  5. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  6. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media