MCP Fantastical サーバー

Fantastical（macOS用の強力なカレンダーアプリ）のためのMCPサーバーです。

なぜこれを使うのか？

• 自然言語によるイベント作成 - Fantasticalの強力な自然言語解析機能を利用できます（「明日午後3時にジョンとミーティング」など）

• スケジュールの確認 - 会話を中断することなく、今日のイベントや今後の予定を確認できます

• カレンダーへの素早いアクセス - Fantasticalで任意の日付に即座にジャンプできます

• カレンダーを認識するAI - Claudeがあなたの空き状況やスケジュールのコンテキストを理解できるようになります

• 設定不要 - 既存のFantasticalおよびカレンダーの設定でそのまま動作します

Related MCP server: Apple Calendar MCP Server

機能

前提条件

• macOS (FantasticalはmacOS専用です)

• Node.js 18以上

• Fantastical がインストールされていること

• ターミナル/Claudeに対するカレンダーへのアクセス権限

インストール

npmを使用する場合 (推奨)

npx mcp-fantastical

ソースからインストールする場合

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

設定

APIキーは不要です。このサーバーはAppleScriptを使用してFantasticalおよびカレンダーアプリと通信します。

Claude Desktopの場合

Claude Desktopの設定ファイルに追加してください：

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

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

Claude Codeの場合

~/.claude.json に追加してください：

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

権限

初回実行時に、以下の権限を許可する必要がある場合があります：

アクセシビリティ (URLスキーム経由でのイベント作成用):

1. システム設定 → プライバシーとセキュリティ → アクセシビリティ

2. 許可リストにターミナル（または使用しているターミナルアプリ）を追加

フルカレンダーアクセス (イベント読み取り用):

ネイティブヘルパーは、アドホック署名された .app バンドル (FantasticalHelper.app) として提供されます。MCPサーバーが初めてカレンダーデータを読み取る際、macOSは 「FantasticalHelper」 によるフルカレンダーアクセスの許可を求めるプロンプトを一度だけ表示します。これを承認してください。

プロンプトを見逃した場合や、後で再許可が必要な場合：

1. システム設定 → プライバシーとセキュリティ → カレンダー

2. FantasticalHelper を有効にする

注: 以前のバージョンでは生のヘルパーバイナリが提供されていましたが、Claude Desktop経由で起動した場合、macOSがTCC権限を割り当てることができず、プロンプトが表示されずにアクセスが拒否されていました（#6）。バンドル化され署名されたヘルパーにより、これが修正されました。

使用例

イベントの作成

• 「明日午後2時にチームとのミーティングを予定して」

• 「金曜日の午前10時に歯科の予約を個人カレンダーに追加して」

• 「毎週月曜日の午前9時に定例ミーティングを繰り返して作成して」

• 「来週の火曜日の午後は集中作業のためにブロックして」

スケジュールの確認

• 「今日のカレンダーの予定は？」

• 「来週のスケジュールを見せて」

• 「明日のミーティングは何がある？」

• 「金曜日の午後は空いている？」

ナビゲーション

• 「カレンダーを来週の月曜日に開いて」

• 「Fantasticalで12月25日を表示して」

• 「カレンダーで来週にジャンプして」

検索

• 「サラとのミーティングをすべて見つけて」

• 「歯科の予約を検索して」

• 「プロジェクトのレビューミーティングを調べて」

利用可能なツール

開発

# Watch mode for development
npm run watch

# Build TypeScript
npm run build

# Run locally
node dist/index.js

トラブルシューティング

「AppleScript error: Not authorized to send Apple events」

アクセシビリティ権限を付与してください：

1. システム設定 → プライバシーとセキュリティ → アクセシビリティを開く

2. 鍵アイコンをクリックして変更を許可する

3. ターミナル（または使用しているターミナルアプリ）を追加して有効にする

カレンダーの権限エラー、またはClaude Desktopで「Calendar access denied」と表示される

macOSのTCC権限は、Claude Desktop → npx → node → ヘルパーというチェーンを通じて継承されません。ネイティブヘルパーはアドホック署名された FantasticalHelper.app バンドルにラップされており、macOSがカレンダー権限を割り当てるための安定したコードIDを持てるようになっています。

解決策:

1. FantasticalHelper によるシステムプロンプトが表示されたら承認してください。他のウィンドウの背後に隠れている可能性があるため、MCPクライアントを再起動して再試行してください。

2. システム設定 → プライバシーとセキュリティ → カレンダーを確認し、FantasticalHelper を有効にしてください。

3. ソースから実行している場合は、バンドルを再ビルドしてください: npm run build:native

4. 何らかの理由でバンドルにコード署名がない場合は、再署名してください: codesign --force --sign - dist/native/FantasticalHelper.app

「Error: This MCP server only works on macOS」

FantasticalはmacOSアプリケーションであるため、このサーバーはmacOSが必要です。AppleScriptを使用してFantasticalおよびカレンダーアプリと通信します。

イベントが表示されない

• FantasticalがiCloud/カレンダーと同期していることを確認してください

• カレンダーアプリが同じカレンダーにアクセスできることを確認してください

• イベントが正しいカレンダーに作成されたか確認してください

• フルカレンダーアクセスを許可してください（上記参照）

Fantasticalが開かない

• Fantasticalがインストールされていることを確認してください

• 手動でFantasticalを開いてみてください

• Fantasticalの設定でURLスキームが有効になっていることを確認してください

ライセンス

MIT - 詳細は LICENSE を参照してください。

リンク

• Fantastical - Fantastical公式サイト

• Model Context Protocol - MCP仕様

• GitHubリポジトリ