home / mcp / mcp fantastical server

MCP Fantastical Server

Provides MCP access to Fantastical and Calendar actions, enabling natural language event creation, viewing, and navigation.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "aplaceforallmystuff-mcp-fantastical": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-fantastical"
      ]
    }
  }
}

You can use the MCP Fantastical Server to control Fantastical and the Calendar app from conversations, enabling natural language event creation, schedule viewing, and calendar navigation directly from your MCP client. This server requires only your existing Fantastical setup and a macOS environment, making it easy to extend chat assistants with calendar-aware capabilities.

How to use

You run the MCP Fantastical Server as an MCP endpoint, and then connect to it from an MCP client such as Claude. The server exposes functions to create events from natural language, view today’s events, fetch upcoming events, open Fantastical to a specific date, list calendars, and search for events. Use these endpoints by issuing the corresponding commands through your MCP client’s MCP integration.

Typical usage patterns include creating events by natural language like “Schedule a meeting with the team tomorrow at 2pm,” viewing today’s schedule, jumping to a specific date in Fantastical, and searching for events by title, location, or notes. You can perform calendar navigation by asking the assistant to open Fantastical to a date or to show a particular month, and you can list all calendars to confirm available targets for event creation.

How to install

Prerequisites you need before starting are macOS (Fantastical is macOS-only), Node.js 18 or newer, Fantastical installed, and calendar access permissions granted to your terminal or the process running the MCP server.

Install steps follow two paths depending on whether you prefer a quick start or building from source.

Recommended quick start

npx mcp-fantastical

From source

If you prefer to build from source, run the following commands to clone, install dependencies, and build the project.

git clone https://github.com/aplaceforallmystuff/mcp-fantastical.git
cd mcp-fantastical
npm install
npm run build

Available tools

fantastical_create_event

Create an event using natural language parsing and send it to Fantastical and the Calendar app.

fantastical_get_today

Retrieve today's calendar events for quick viewing.

fantastical_get_upcoming

Fetch upcoming events for a specified number of days.

fantastical_show_date

Open Fantastical to a specific date.

fantastical_get_calendars

List all available calendars.

fantastical_search

Search for events by query such as title, location, or notes.