Apple Calendar MCP

🚀 apple-calendar-mcp

Appleのカレンダーに対応したMCPサーバーで、ネイティブのEventKit APIを使って繰り返しイベントを適切にサポートします。

🚀 クイックスタート

このプロジェクトは、AppleのネイティブEventKitフレームワークを使って、繰り返しイベントを正しく展開します。以下の手順でセットアップしてください。

✨ 主な機能

• AppleScriptベースのカレンダー統合では正しく展開できない繰り返しイベントを、適切に個別のイベントとして展開します。
• 6つのMCPツールを提供し、カレンダーの操作をサポートします。

📦 インストール

オプション1: npm（推奨）

claude mcp add --scope user apple-calendar -- npx apple-calendar-mcp

このコマンドでパッケージが自動的にダウンロードされ、Swiftブリッジがコンパイルされ、MCPサーバーが登録されます。XcodeまたはSwiftツールチェーンがインストールされたmacOSが必要です。

インストール後、カレンダーへのアクセスを許可します。

npx apple-calendar-mcp doctor

プロンプトが表示されたら、完全なアクセスを許可します。以前にアクセスを拒否していた場合は、以下のコマンドを実行します。

tccutil reset Calendar
npx apple-calendar-mcp doctor

オプション2: ソースからインストール

git clone https://github.com/EgorKurito/apple-calendar-mcp.git
cd apple-calendar-mcp
./scripts/build.sh

カレンダーへのアクセスを許可します。

swift/.build/release/apple-bridge doctor

Claude Codeに接続するには、以下のいずれかの方法を使用します。

プロジェクトレベルの .mcp.json .mcp.json.example をプロジェクト内の .mcp.json にコピーし、パスを更新します。

{
  "mcpServers": {
    "apple-calendar": {
      "command": "node",
      "args": ["/path/to/apple-calendar-mcp/build/index.js"],
      "env": {
        "APPLE_BRIDGE_BIN": "/path/to/apple-calendar-mcp/swift/.build/release/apple-bridge"
      }
    }
  }
}

ユーザーレベルのCLI登録

claude mcp add --scope user apple-calendar \
  node /path/to/apple-calendar-mcp/build/index.js \
  -e APPLE_BRIDGE_BIN=/path/to/apple-calendar-mcp/swift/.build/release/apple-bridge

💻 使用例

基本的な使用法

# システム診断をチェックする
swift/.build/release/apple-bridge doctor

# カレンダーを一覧表示する
swift/.build/release/apple-bridge calendars

# 今日のイベントを取得する
swift/.build/release/apple-bridge today

# 日付範囲内のイベントを取得する（繰り返しイベントが展開される）
swift/.build/release/apple-bridge events --start "2026-02-01T00:00:00Z" --end "2026-02-28T23:59:59Z"

📚 ドキュメント

MCPツール

🔧 技術詳細

Claude Code ──stdio JSON-RPC──▶ TypeScript MCP Server ──execa──▶ Swift CLI (apple-bridge) ──EventKit──▶ macOS Calendar

• TypeScript層 — 6つのツールを持つMCPサーバーで、Zodによるバリデーション、stdioを介したJSON-RPCをサポートします。
• Swift層 — EventKitを使用するCLIバイナリで、JSONエンベロープ {status, data, error} を返します。

トラブルシューティング

カレンダーへのアクセスが拒否された場合

TCCのパーミッションをリセットして、再度実行します。

tccutil reset Calendar
swift/.build/release/apple-bridge doctor

繰り返しイベントが展開されない場合

この問題はこのプロジェクトが解決する正確な問題です。AppleScriptベースの代替手段ではなく、MCPツール（predicateForEvents を使用）を使用していることを確認してください。

ISO 8601の解析エラーが発生した場合

Swiftバイナリは、日付を 2026-02-07T10:00:00Z または 2026-02-07T10:00:00.000Z の形式で期待しています。

コントリビュート方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. ./scripts/build.sh を実行してビルドを検証します。
5. プルリクエストを送信します。

📄 ライセンス

MIT