MCP iCal サーバー

🗓️ macOS 向け自然言語カレンダー管理

🌟 概要

自然言語を使って、macOS カレンダーの操作方法を変革しましょう。mcp-ical サーバーは、モデルコンテキストプロトコル (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"

Related MCP server: Apple Calendar MCP

✨ 特徴

📅 イベント作成

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

"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 カレンダーがシームレスに統合されます

💡プロのヒント：カスタムカレンダーにイベントを作成できるため、GoogleカレンダーをiCloudカレンダーと同期している場合は、このMCPサーバーを使用してGoogleカレンダーにもイベントを作成できます。イベントの作成/更新時にGoogleカレンダーを指定するだけです。

🚀 クイックスタート

💡注：この手順はClaude for Desktopを使用したMCPサーバーの設定に重点を置いていますが、このサーバーはMCP対応のクライアントであればどれでも使用できます。他のクライアントの使用方法の詳細については、 MCPドキュメントをご覧ください。

前提条件

• UVパッケージマネージャー

• カレンダーアプリが設定されたmacOS

• MCPクライアント -デスクトップ版のClaudeが推奨されます

インストール

この MCP サーバーは MCP 互換クライアントであればどれでも使用できますが、以下の手順はデスクトップ版 Claude で使用するためのものです。

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

   # Clone the repository
   git clone https://github.com/Omar-V2/mcp-ical.git
   cd mcp-ical
   
   # Install dependencies
   uv sync

2. デスクトップ用にClaudeを構成する

   ~/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. 使い始めましょう！

   Try: "What's my schedule looking like for next week?"

🔑注：カレンダー関連のコマンドを初めて使用する際、macOS はカレンダーへのアクセスを求めるプロンプトを表示します。このプロンプトは、上記のようにターミナルから Claude を起動した場合にのみ表示されます。

🧪 テスト

⚠️警告：テストでは一時的なカレンダーとイベントが作成されます。クリーンアップは自動的に行われますが、開発環境でのみテストを実行してください。

# Install dev dependencies
uv sync --dev

# Run test suite
uv run pytest tests

🐛 既知の問題

定期的なイベント

• 非標準の定期スケジュールは必ずしも正しく設定されない場合があります

• Claude 3.5 Sonnet は Haiku よりも良い結果が出ました

• 終日イベントの定期的なリマインダーのタイミングが 1 日ずれる場合があります

🤝 貢献する

フィードバックと貢献を歓迎します。ご協力いただける方法は次のとおりです。

1. リポジトリをフォークする

2. 機能ブランチを作成する

3. 変更をコミットする

4. ブランチにプッシュする

5. プルリクエストを開く

📝 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

🙏 謝辞

• モデルコンテキストプロトコルで構築

• PyObjCで構築された macOS カレンダー統合