MCP Fantastical Server

MCP server for Fantastical - the powerful calendar app for macOS.

Why Use This?

• Natural language event creation - Use Fantastical's powerful natural language parsing ("Meeting with John tomorrow at 3pm")

• View your schedule - Check today's events or upcoming appointments without leaving your conversation

• Quick calendar access - Jump to any date in Fantastical instantly

• Calendar-aware AI - Let Claude understand your availability and schedule context

• Zero configuration - Works with your existing Fantastical and Calendar setup

Features

Prerequisites

• macOS (Fantastical is macOS-only)

• Node.js 18+

• Fantastical installed

• Calendar access permissions for Terminal/Claude

Installation

Using npm (Recommended)

From Source

Configuration

No API keys required - this server uses AppleScript to communicate with Fantastical and the Calendar app.

For Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

For Claude Code

Add to ~/.claude.json:

Permissions

On first run, you may need to grant accessibility permissions:

1. System Preferences → Privacy & Security → Accessibility

2. Add Terminal (or your terminal app) to the allowed list

Usage Examples

Creating Events

• "Schedule a meeting with the team tomorrow at 2pm"

• "Add dentist appointment Friday at 10am to my Personal calendar"

• "Create a recurring standup every Monday at 9am"

• "Block off next Tuesday afternoon for deep work"

Viewing Schedule

• "What's on my calendar today?"

• "Show me my schedule for the next week"

• "What meetings do I have tomorrow?"

• "Am I free on Friday afternoon?"

Navigation

• "Open my calendar to next Monday"

• "Show me December 25th in Fantastical"

• "Jump to next week in my calendar"

Searching

• "Find all meetings with Sarah"

• "Search for dentist appointments"

• "Look up project review meetings"

Available Tools

Development

Troubleshooting

"AppleScript error: Not authorized to send Apple events"

Grant accessibility permissions:

1. Open System Preferences → Privacy & Security → Accessibility

2. Click the lock to make changes

3. Add Terminal (or your terminal app) and enable it

"Error: This MCP server only works on macOS"

This server requires macOS because Fantastical is a macOS application. It uses AppleScript to communicate with Fantastical and the Calendar app.

Events not showing up

• Ensure Fantastical is syncing with iCloud/Calendar

• Check that Calendar.app has access to the same calendars

• Verify the event was created in the correct calendar

Fantastical not opening

• Ensure Fantastical is installed

• Try opening Fantastical manually first

• Check that URL schemes are enabled in Fantastical preferences

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT - see LICENSE for details.

Links

• Fantastical - Official Fantastical website

• Model Context Protocol - MCP specification

• GitHub Repository