Macbook Calendar Mcp Server

Mac Calendar MCP Server 📅

The Mac Calendar MCP Server is a native, zero-dependency bridge between Claude (or any MCP client) and your local macOS Calendar app.

Unlike other calendar integrations that require complex Google Cloud / OAuth configurations or exposing your private iCloud data to third-party web APIs, this server communicates entirely locally using macOS Apple Events. Your calendar data never leaves your machine.

---

🔥 Key Benefits

• 100% Local & Private: No iCloud passwords, no OAuth tokens, no cloud relays. It securely reads the local database on your Mac.
• Zero Configuration: Whatever calendars are visible in your Mac's Calendar app (Work, Home, Subscribed Calendars) are instantly available to Claude.
• Highly Secure Architecture: Engineered to completely thwart prompt injection. User inputs are parameterized strictly as argv shells instead of script interpolation, removing any risk of arbitrary code execution.
• Native TCC Support: Operates respecting macOS Transparency, Consent, and Control. You must manually grant UI permission the very first time it runs, meaning nothing can scrape your calendar silently.

---

🛠️ Tools Included

1. list_calendars Quickly retrieves a list of all calendar names currently available on your Mac.
2. get_events Fetches events within a specified date range for a given calendar name. It safely standardizes inputs using ISO-8601 formatting to avoid locale-specific timestamp crashes.
3. add_event Securely creates a new calendar event, mapping the title, start/end dates, location, and description directly into the Mac Calendar application.

---

🚀 Quick Setup (Claude Desktop)

There is no complex installation required. Simply add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "mac-calendar": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jayaprakashnarayana/mac-calendar-mcp.git",
        "mac-calendar-mcp"
      ]
    }
  }
}