Macos Calendar MCP

🚀 macOS Calendar MCP Server

AppleScriptを使用して、macOS Calendarとシームレスに統合するためのModel Context Protocol (MCP)サーバーです。OAuthの設定は不要です！

✨ 主な機能

• 🍎 macOSネイティブ統合 - AppleScriptを使用して、macOS Calendarと直接やり取りします。
• 📅 カレンダーの完全管理 - カレンダーイベントの作成、一覧表示、検索ができます。
• 🚀 ゼロ設定 - OAuthやAPIキーが不要で、すぐに使えます。
• 🔧 MCP互換 - Claude Code CLIや他のMCPクライアントと連携します。
• 📱 複数カレンダー対応 - すべてのカレンダー（個人用、仕事用など）で動作します。

🚀 クイックスタート

前提条件

• macOS（AppleScriptサポートに必要）
• Node.js 16以上
• カレンダーアプリ（macOSに事前インストールされています）

📦 インストール

1. リポジトリをクローンします：

git clone https://github.com/xybstone/macos-calendar-mcp.git
cd macos-calendar-mcp

2. 依存関係をインストールします：

npm install

3. パーミッションを付与します：
   • 初回実行時に、macOSがカレンダーアプリのパーミッションを求めます。
   • MCPサーバーがカレンダーを管理できるようにアクセスを許可してください。

Claude Code CLIでの使用方法

.claude_projectファイルに以下を追加します：

{
  "mcpServers": {
    "macos-calendar": {
      "command": "node",
      "args": ["/path/to/macos-calendar-mcp/macos-calendar-mcp.js"]
    }
  }
}

または、直接実行します：

node macos-calendar-mcp.js

💻 使用例

基本的な使用法

イベントの作成

{
  "title": "Team Meeting",
  "startDate": "2025-07-05 14:00",
  "endDate": "2025-07-05 15:00", 
  "calendar": "Work",
  "description": "Weekly team sync",
  "location": "Conference Room A"
}

カレンダーの一覧表示

// Returns all available calendars

イベントの検索

{
  "query": "meeting",
  "calendar": "Work"
}

📚 ドキュメント

日付フォーマット

YYYY-MM-DD HH:MM（24時間形式）のフォーマットを使用します。

例:

• 2025-07-05 14:00（午後2:00）
• 2025-12-25 09:30（午前9:30）
• 2025-07-10 18:00（午後6:00）

タイムゾーンの扱い:

• タイムゾーンの変換問題を避けるために、macOSのネイティブな時間処理を使用します。
• すべての時間はシステムのローカルタイムゾーンで解釈されます。
• UTC変換や夏時間の調整は必要ありません。

サポートされるカレンダー

以下を含むすべてのmacOS Calendarカレンダーで動作します：

• 個人用カレンダー
• 仕事用カレンダー
• 共有カレンダー
• 購読カレンダー（iCloud、Googleなど）

利用可能なツール

トラブルシューティング

パーミッションの問題

パーミッションエラーが発生した場合：

1. システム環境設定 → セキュリティとプライバシー → プライバシーを開きます。
2. 左側のサイドバーから「カレンダー」を選択します。
3. ターミナル（またはアプリ）がアクセスできることを確認します。

AppleScriptのエラー

• カレンダーアプリがインストールされてアクセス可能であることを確認します。
• カレンダー名が正しいことを確認します（大文字と小文字が区別されます）。
• 日付フォーマットが期待されるパターンと一致することを確認します。

タイムゾーンの問題

イベントが誤った時間に表示される場合：

1. システムのタイムゾーン設定を確認します。
2. fix-event-timesツールを使用して、既存のイベントを修正します。
3. 日付フォーマットがYYYY-MM-DD HH:MM（24時間形式）であることを確認します。
4. MCPはタイムゾーンの変換問題を避けるために、macOSのネイティブな時間処理を使用します。

コントリビュートする方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. macOSで十分にテストします。
5. プルリクエストを送信します。

なぜこのMCPなのか？

複雑なOAuth設定が必要なGoogle Calendarの統合とは異なり、このMCPは：

• ✅ 設定なしですぐに動作します。
• ✅ 既存のmacOS Calendar設定と統合します。
• ✅ すべてのカレンダーソース（iCloud、Google、Exchangeなど）をサポートします。
• ✅ 基本的な操作にはインターネット接続が不要です。
• ✅ プライバシーを尊重します - すべてがローカルで実行されます。

OAuthの面倒さを避けてカレンダーを統合したい開発者に最適です！

プライバシーとセキュリティ

• ✅ ローカル処理：すべてのカレンダー操作はあなたのマシン上でローカルに実行されます。
• ✅ データアップロードなし：あなたのカレンダーデータは決してデバイスを離れません。
• ✅ プライバシー重視：OAuthトークン、クラウドサービス、トラッキングはありません。
• ⚠️ 個人情報：テスト中は、個人イベントを含むファイルを公開リポジトリにコミットしないでください。

データ保護

このプロジェクトには、個人情報を含むイベントデータが誤ってコミットされるのを防ぐための.gitignoreパターンが含まれています：

• *events*.json - イベントデータファイル
• *meetings*.json - 会議スケジュール
• *schedule*.json - スケジュールファイル
• private-*.json - すべての個人情報ファイル

📄 ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください。