fantastical-mcp

An MCP server that gives AI assistants read/write access to your Fantastical calendar on macOS.

fantastical-mcp reads calendar events directly from Fantastical's local SQLite database and creates events via Fantastical's x-fantastical3:// URL scheme. No TCC permissions, no API keys, no network access -- it works entirely offline using the data Fantastical already stores on your Mac.

• Read -- Query events by date range, calendar, or full-text search
• Write -- Create events using Fantastical's natural language parser
• Navigate -- Open Fantastical to a specific date

• macOS
• Fantastical installed with at least one calendar
• An MCP client, such as Claude Desktop or Claude Code
• uv Python package manager: brew install uv

Fantastical MCP is published on PyPI and can be run directly with uvx:

uvx fantastical-mcp

Configure your MCP client to use uvx with fantastical-mcp as the argument.

1. Download the latest .mcpb file from the releases page
2. Double-click the file
3. Done!

1. Go to Claude → Settings → Developer → Edit Config
2. Add the Fantastical server:

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

1. Save and restart Claude Desktop

claude mcp add-json fantastical '{"command":"uvx","args":["fantastical-mcp"]}'

To make it available globally (across all projects), add -s user:

claude mcp add-json -s user fantastical '{"command":"uvx","args":["fantastical-mcp"]}'

After installation:

• If using Claude Desktop, you should see "Fantastical MCP