agenda-mcp

MCP server that gives LLMs full access to your macOS Calendar app. Built on JXA (JavaScript for Automation) to talk directly to EventKit — no Swift compilation needed.

Install

npm install agenda-mcp

Tools

| Tool | Description | |------|-------------| | list_calendars | List all calendars with name, color, and writable status | | list_events | List events in a date range, optionally filtered by calendar | | search_events | Search events by keyword across title, location, and notes | | create_event | Create a new event on any writable calendar | | update_event | Update fields on an existing event by UID | | delete_event | Delete an event by UID |

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "calendar": {
      "command": "npx",
      "args": ["agenda-mcp"]
    }
  }
}

Claude Code

claude mcp add calendar npx agenda-mcp

Permissions

On first run, macOS will ask you to grant calendar access. If you see a "Not authorized" error, go to System Settings > Privacy & Security > Automation and allow your terminal/app to control Calendar.

Development

git clone https://github.com/onursagir/agenda-mcp.git
cd agenda-mcp
npm install
npm run build    # compile TypeScript to dist/
npm run dev      # run directly with tsx

Requirements

• macOS (uses osascript under the hood)
• Node.js >= 18

Credits

Built with Claude Code.

License

MIT