MCP iCal Server

MCP iCal Server

🌟 概要

自然言語を使って、macOS カレンダーの操作方法を変えましょう！mcp-ical サーバーは Model Context Protocol（MCP）を活用し、カレンダー管理を会話形式で行えるようにします。

You: "What's my schedule for next week?"
Claude: "Let me check that for you..."
[Displays a clean overview of your upcoming week]

You: "Add a lunch meeting with Sarah tomorrow at noon"
Claude: "✨ 📅 Created: Lunch with Sarah Tomorrow, 12:00 PM"

✨ 特長

📅 イベントの作成

自然言語を瞬時にカレンダーイベントに変換します！

"Schedule a team lunch next Thursday at 1 PM at Bistro Garden"
↓
📎 Created: Team Lunch
   📅 Thursday, 1:00 PM
   📍 Bistro Garden

対応機能

• カレンダーの選択
• 場所とメモ
• スマートリマインダー
• 繰り返しイベント

パワーユーザー向けの例

🔄 Recurring Events:
"Set up my weekly team sync every Monday at 9 AM with a 15-minute reminder"

📝 Detailed Events:
"Schedule a product review meeting tomorrow from 2-4 PM in the Engineering calendar, 
add notes about reviewing Q1 metrics, and remind me 1 hour before"

📱 Multi-Calendar Support:
"Add a dentist appointment to my Personal calendar for next Wednesday at 3 PM"

🔍 スマートなスケジュール管理と空き状況

自然なクエリですばやくスケジュールを確認できます。

"What's on my calendar for next week?"
↓
📊 Shows your upcoming events with smart formatting

"When am I free to schedule a 2-hour meeting next Tuesday?"
↓
🕒 Available time slots found:
   • Tuesday 10:00 AM - 12:00 PM
   • Tuesday 2:00 PM - 4:00 PM

✏️ イベントのインテリジェントな更新

自然な言葉でイベントを変更できます。

Before: "Move tomorrow's team meeting to 3 PM instead"
↓
After: ✨ Meeting rescheduled to 3:00 PM

更新できる項目

• 時刻と日付の変更
• カレンダー間の移動
• 場所の更新
• メモの追加
• リマインダーの調整
• 繰り返しパターンの変更

📊 カレンダー管理

• 利用可能なすべてのカレンダーを表示
• スマートなカレンダーの提案
• iCloud と連携している場合は Google Calendar とシームレスに連携

💡 ヒント：カスタムカレンダーにイベントを作成できるため、Google Calendar を iCloud Calendar と同期していれば、この MCP サーバーを使って Google Calendar にもイベントを作成できます！イベントの作成や更新時に Google カレンダーを指定してください。

🚀 クイックスタート

💡 注記：ここでは MCP サーバーを Claude for Desktop に設定する手順を説明しますが、このサーバーは MCP 対応の任意のクライアントで使用できます。各種クライアントの使用方法について詳しくは、MCP のドキュメントをご覧ください。

前提条件

• uv パッケージマネージャー
• カレンダーアプリが設定された macOS
• MCP クライアント — Claude for desktop を推奨

インストール

この MCP サーバーは MCP 対応の任意のクライアントで使用できますが、以下の手順は Claude for desktop での使用を対象としています。

1. クローンとセットアップ

   # リポジトリをクローン
   git clone https://github.com/Omar-V2/mcp-ical.git
   cd mcp-ical
   
   # 依存関係をインストール
   uv sync
   

2. Claude for Desktop の設定

   ~/Library/Application\ Support/Claude/claude_desktop_config.json を作成または編集します。

   {
       "mcpServers": {
           "mcp-ical": {
               "command": "uv",
               "args": [
                   "--directory",
                   "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-ical",
                   "run",
                   "mcp-ical"
               ]
           }
       }
   }
   

3. カレンダーにアクセスできるよう Claude を起動

   ⚠️ 重要：カレンダーのアクセス許可を正しく求めるには、ターミナルから Claude を起動する必要があります。Finder から直接起動しても、アクセス許可の確認は表示されません。

   ターミナルで次のコマンドを実行します。

   /Applications/Claude.app/Contents/MacOS/Claude
   

   ⚠️ 警告：代わりにカレンダーへのアクセスを手動で許可することもできますが、システムファイルの変更を伴うため、リスクを理解している場合にのみ実施してください。

4. 使い始めましょう！

   例：「来週の予定はどんな感じですか？」
   

🔑 注記：カレンダー関連のコマンドを初めて使用するとき、macOS がカレンダーへのアクセス許可を求めます。この確認は、上記の手順どおりにターミナルから Claude を起動した場合にのみ表示されます。

🧪 テスト

⚠️ Warning: テストでは一時的なカレンダーや予定が作成されます。自動的にクリーンアップされますが、テストは開発環境でのみ実行してください。

# Install dev dependencies
uv sync --dev

# Run test suite
uv run pytest tests

🐛 既知の問題

繰り返し予定

• 標準的でない繰り返しスケジュールは、正しく設定されない場合があります
• Haiku よりも Claude 3.5 Sonnet のほうが良い結果が得られます
• 終日の繰り返し予定のリマインダー時刻が、1 日ずれる場合があります

🤝 コントリビューション

フィードバックやコントリビューションを歓迎します。以下の方法でご協力いただけます。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します
3. 変更をコミットします
4. ブランチにプッシュします
5. プルリクエストを作成します

📝 ライセンス

このプロジェクトは MIT ライセンスのもとで公開されています。詳細は LICENSE ファイルをご覧ください。

🙏 謝辞

• Model Context Protocol を使用して構築されています
• macOS カレンダーとの連携は PyObjC を使用して構築されています