MCP Fantastical Server

MCP-Server für Fantastical – die leistungsstarke Kalender-App für macOS.

Warum dieses Tool nutzen?

• Erstellung von Ereignissen in natürlicher Sprache – Nutzen Sie die leistungsstarke Analyse natürlicher Sprache von Fantastical („Meeting mit John morgen um 15 Uhr“)

• Zeitplan einsehen – Überprüfen Sie die heutigen Ereignisse oder anstehende Termine, ohne Ihre Konversation zu verlassen

• Schneller Kalenderzugriff – Springen Sie sofort zu einem beliebigen Datum in Fantastical

• Kalenderbewusste KI – Lassen Sie Claude Ihre Verfügbarkeit und Ihren Zeitplan-Kontext verstehen

• Keine Konfiguration – Funktioniert mit Ihrem bestehenden Fantastical- und Kalender-Setup

Related MCP server: Apple Calendar MCP Server

Funktionen

Voraussetzungen

• macOS (Fantastical ist nur für macOS verfügbar)

• Node.js 18+

• Fantastical installiert

• Kalender-Zugriffsberechtigungen für Terminal/Claude

Installation

Über npm (Empfohlen)

npx mcp-fantastical

Aus dem Quellcode

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

Konfiguration

Es sind keine API-Schlüssel erforderlich – dieser Server verwendet AppleScript, um mit Fantastical und der Kalender-App zu kommunizieren.

Für Claude Desktop

Fügen Sie dies zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:

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

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

Für Claude Code

Fügen Sie dies zu ~/.claude.json hinzu:

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

Berechtigungen

Beim ersten Ausführen müssen Sie möglicherweise die folgenden Berechtigungen erteilen:

Bedienungshilfen (für die Ereigniserstellung über URL-Schema):

1. Systemeinstellungen → Datenschutz & Sicherheit → Bedienungshilfen

2. Fügen Sie Terminal (oder Ihre Terminal-App) zur Liste der erlaubten Apps hinzu

Vollständiger Kalenderzugriff (zum Lesen von Ereignissen):

Der native Helfer wird als ad-hoc-signiertes .app-Paket (FantasticalHelper.app) ausgeliefert. Wenn der MCP-Server zum ersten Mal Kalenderdaten liest, zeigt macOS eine einmalige Aufforderung an, die „FantasticalHelper“ zugeschrieben wird und um den vollständigen Kalenderzugriff bittet. Bestätigen Sie diese.

Falls Sie die Aufforderung verpasst haben oder sie später erneut erteilen müssen:

1. Systemeinstellungen → Datenschutz & Sicherheit → Kalender

2. Aktivieren Sie FantasticalHelper

Hinweis: Frühere Versionen lieferten eine rohe Helfer-Binärdatei aus, der macOS keine TCC-Berechtigung zuweisen konnte, wenn sie unter Claude Desktop gestartet wurde – die Aufforderung erschien nie und der Zugriff wurde stillschweigend verweigert (#6). Der gebündelte + signierte Helfer behebt dies.

Nutzungsbeispiele

Ereignisse erstellen

• „Plane morgen um 14 Uhr ein Meeting mit dem Team“

• „Füge am Freitag um 10 Uhr einen Zahnarzttermin zu meinem persönlichen Kalender hinzu“

• „Erstelle ein wiederkehrendes Standup jeden Montag um 9 Uhr“

• „Blockiere nächsten Dienstagnachmittag für konzentriertes Arbeiten“

Zeitplan einsehen

• „Was steht heute in meinem Kalender?“

• „Zeige mir meinen Zeitplan für die nächste Woche“

• „Welche Meetings habe ich morgen?“

• „Bin ich am Freitagnachmittag frei?“

Navigation

• „Öffne meinen Kalender für nächsten Montag“

• „Zeige mir den 25. Dezember in Fantastical“

• „Springe in meinem Kalender zur nächsten Woche“

Suchen

• „Finde alle Meetings mit Sarah“

• „Suche nach Zahnarztterminen“

• „Suche nach Projektbesprechungen“

Verfügbare Tools

Entwicklung

# Watch mode for development
npm run watch

# Build TypeScript
npm run build

# Run locally
node dist/index.js

Fehlerbehebung

„AppleScript error: Not authorized to send Apple events“

Gewähren Sie Berechtigungen für Bedienungshilfen:

1. Öffnen Sie Systemeinstellungen → Datenschutz & Sicherheit → Bedienungshilfen

2. Klicken Sie auf das Schloss, um Änderungen vorzunehmen

3. Fügen Sie Terminal (oder Ihre Terminal-App) hinzu und aktivieren Sie es

Kalender-Berechtigungsfehler oder „Calendar access denied“ unter Claude Desktop

macOS TCC-Berechtigungen werden nicht über die Kette Claude Desktop → npx → node → Helfer vererbt. Der native Helfer ist in einem ad-hoc-signierten FantasticalHelper.app-Paket verpackt, damit macOS eine stabile Code-Identität hat, der die Kalenderberechtigung zugeschrieben werden kann.

Lösungen:

1. Suchen Sie nach einer einmaligen Systemaufforderung, die FantasticalHelper zugeschrieben wird, und bestätigen Sie diese. Falls sie hinter einem anderen Fenster erschien, starten Sie Ihren MCP-Client neu und versuchen Sie es erneut.

2. Überprüfen Sie Systemeinstellungen → Datenschutz & Sicherheit → Kalender und aktivieren Sie FantasticalHelper.

3. Wenn Sie aus dem Quellcode ausführen, erstellen Sie das Paket neu: npm run build:native.

4. Falls dem Paket aus irgendeinem Grund eine Codesignatur fehlt, signieren Sie es erneut: codesign --force --sign - dist/native/FantasticalHelper.app.

„Error: This MCP server only works on macOS“

Dieser Server erfordert macOS, da Fantastical eine macOS-Anwendung ist. Er verwendet AppleScript, um mit Fantastical und der Kalender-App zu kommunizieren.

Ereignisse werden nicht angezeigt

• Stellen Sie sicher, dass Fantastical mit iCloud/Kalender synchronisiert

• Überprüfen Sie, ob die Kalender-App Zugriff auf dieselben Kalender hat

• Überprüfen Sie, ob das Ereignis im richtigen Kalender erstellt wurde

• Gewähren Sie vollständigen Kalenderzugriff (siehe oben)

Fantastical öffnet sich nicht

• Stellen Sie sicher, dass Fantastical installiert ist

• Versuchen Sie, Fantastical zuerst manuell zu öffnen

• Überprüfen Sie, ob URL-Schemata in den Fantastical-Einstellungen aktiviert sind

Lizenz

MIT – siehe LICENSE für Details.

Links

• Fantastical – Offizielle Fantastical-Website

• Model Context Protocol – MCP-Spezifikation

• GitHub-Repository