MCP Ical

🚀 MCP ical サーバー

🗓️ macOS上でのカレンダーの自然言語管理を実現します。このサーバーは、ユーザーが自然な言葉でカレンダーを操作できるようにし、直感的で便利なカレンダー管理体験を提供します。

🚀 クイックスタート

前提条件

• macOS (10.9 以上のバージョン)
• Python 3.12 以上
• Claude アプリケーション

起動手順

1. Claude アプリ をダウンロードしてインストールします。
2. ターミナルで以下の起動コマンドを実行します。

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

✨ 主な機能

📅 イベント作成

自然言語を即座にカレンダーイベントに変換できます！

"来週の木曜日の午後1時にチームとランチを予約して"
↓
📎 作成：チームランチ
   📅 木曜日、午後1:00
   📍 Bistro Garden

機能詳細：

• 迅速な追加：シンプルな言語指示でイベントを作成できます。
• スマートな解析：日付、時間、関連する詳細を自動的に識別します。

スマートな日程管理

試してみてください："来週の予定は？"

イベント更新

自然言語で既存のイベントを更新できます。例："来週の木曜日のランチを午後2時に変更して。"

🧪 テスト

# 開発用の依存関係をインストールする
uv sync --dev

# テストスイートを実行する
uv run pytest tests

🐛 既知の問題

繰り返しイベント

• 非標準的な繰り返し設定は正しく設定できない場合があります。
• Claude 3.5 Sonnet を使用するとより良い結果が得られます。
• すべての日次イベントの通知時間が1日ずれることがあります。

🤝 コントリビューション

フィードバックやコントリビューションを歓迎します！

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

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細は LICENSE ファイルを参照してください。

🙏 謝辞

• モデルコンテキストプロトコル を使用して構築されています。
• macOS カレンダーの統合には PyObjC を使用しています。