Che Ical MCP

🚀 che-ical-mcp

macOSのカレンダーとリマインダーを管理するMCPサーバー - Native EventKitと統合され、完全なカレンダーとタスク管理を実現します。

English | 繁體中文

🚀 クイックスタート

Claude Desktopの場合

オプションA: MCPBワンクリックインストール (推奨)

Releases から最新の .mcpb ファイルをダウンロードし、ダブルクリックしてインストールします。

オプションB: 手動設定

~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "che-ical-mcp": {
      "command": "/usr/local/bin/che-ical-mcp"
    }
  }
}

Claude Code (CLI)の場合

# 必要に応じて ~/bin を作成
mkdir -p ~/bin

# 最新のリリースをダウンロード
curl -L https://github.com/kiki830621/che-ical-mcp/releases/latest/download/CheICalMCP -o ~/bin/CheICalMCP
chmod +x ~/bin/CheICalMCP

# Claude Codeに追加
# --scope user    : すべてのプロジェクトで利用可能 (~/\.claude.jsonに保存)
# --transport stdio: stdin/stdoutを介したローカルバイナリ実行
# --              : claudeオプションとコマンドの区切り
claude mcp add --scope user --transport stdio che-ical-mcp -- ~/bin/CheICalMCP

💡 使用アドバイス：バイナリは常に ~/bin/ などのローカルディレクトリにインストールしてください。Dropbox、iCloud、OneDriveなどのクラウド同期フォルダに配置すると、ファイル同期操作によりMCP接続がタイムアウトする可能性があります。

ソースからビルド (オプション)

git clone https://github.com/kiki830621/che-ical-mcp.git
cd che-ical-mcp
swift build -c release

初回使用時、macOSはカレンダーとリマインダーのアクセス許可を求めます。「許可」をクリックしてください。

✨ 主な機能

📦 インストール

必要条件

• macOS 13.0以上
• Xcodeコマンドラインツール (ソースからビルドする場合のみ)

Claude Desktopの場合

方法1: MCPBワンクリックインストール (推奨)

1. Releases から che-ical-mcp.mcpb をダウンロードします。
2. .mcpb ファイルをダブルクリックしてインストールします。
3. Claude Desktopを再起動します。

方法2: 手動設定

1. バイナリをダウンロードします。

   curl -L https://github.com/kiki830621/che-ical-mcp/releases/latest/download/CheICalMCP -o /usr/local/bin/che-ical-mcp
   chmod +x /usr/local/bin/che-ical-mcp
   

2. ~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

   {
     "mcpServers": {
       "che-ical-mcp": {
         "command": "/usr/local/bin/che-ical-mcp"
       }
     }
   }
   

3. Claude Desktopを再起動します。

Claude Code (CLI)の場合

# 必要に応じて ~/bin を作成
mkdir -p ~/bin

# バイナリをダウンロード
curl -L https://github.com/kiki830621/che-ical-mcp/releases/latest/download/CheICalMCP -o ~/bin/CheICalMCP
chmod +x ~/bin/CheICalMCP

# Claude Codeに登録 (ユーザースコープ = すべてのプロジェクトで利用可能)
claude mcp add --scope user --transport stdio che-ical-mcp -- ~/bin/CheICalMCP

ソースからビルド (オプション)

git clone https://github.com/kiki830621/che-ical-mcp.git
cd che-ical-mcp
swift build -c release

# ~/binにコピーして登録
cp .build/release/CheICalMCP ~/bin/
claude mcp add --scope user --transport stdio che-ical-mcp -- ~/bin/CheICalMCP

権限の付与

初回使用時、macOSはカレンダーとリマインダーのアクセス許可を求めます。両方とも「許可」をクリックしてください。

⚠️ 重要な注意

macOS Sequoia (15.x)の場合、許可ダイアログはMCPサーバーを起動した親アプリケーションに帰属し、バイナリ自体ではありません。つまり、以下のようになります。

環境	許可の帰属先
Claude Desktop	Claude Desktop.app ✅ (自動的に動作します)
Terminal.app 内のClaude Code	Terminal.app ✅ (自動的に動作します)
VS Code 内のClaude Code	VS Code ❌ (ダイアログが表示されない場合があります)
iTerm2 内のClaude Code	iTerm2 ✅ (自動的に動作します)

許可ダイアログが表示されない場合 (VS Codeでよくあります)、VS CodeのInfo.plistに NSCalendarsFullAccessUsageDescription を追加する必要があります。

# VS Codeにカレンダー使用説明を追加
/usr/libexec/PlistBuddy -c "Add :NSCalendarsFullAccessUsageDescription string 'VS Code needs calendar access for MCP extensions.'" \
  "/Applications/Visual Studio Code.app/Contents/Info.plist"
/usr/libexec/PlistBuddy -c "Add :NSRemindersFullAccessUsageDescription string 'VS Code needs reminders access for MCP extensions.'" \
  "/Applications/Visual Studio Code.app/Contents/Info.plist"

# VS Codeを再署名 (Info.plistの変更後に必要)
codesign -s - -f --deep "/Applications/Visual Studio Code.app"

# VS Codeを再起動すると、許可ダイアログが表示されます

注意: この変更はVS Codeが更新されると上書きされます。VS Codeの更新後に再度適用する必要があります。

📚 ドキュメント

v1.0.0の機能

柔軟な日付解析

すべての日付パラメータは、以下の4つの形式を受け付けるようになりました。

曖昧なカレンダーマッチング

カレンダー名は大文字と小文字を区別せずにマッチングされます。見つからない場合、エラーメッセージにすべての利用可能なカレンダーが表示されます。

強化されたリスト/削除ツール

• list_events: filter (all/past/future/all_day), sort (asc/desc), limit
• list_reminders: filter (all/incomplete/completed/overdue), sort (due_date/creation_date/priority/title), limit
• delete_events_batch: 日付範囲モード (before_date/after_date) + dry_run プレビュー

破壊的変更: list_events と list_reminders は、今後 {events/reminders: [...], metadata: {...}} を返すようになり、単純な配列ではなくなります。

💻 使用例

カレンダー管理

"すべてのカレンダーをリスト表示"
"来週の予定は何ですか？"
"明日の午後2時に 'チーム同期' というタイトルの会議を作成"
"金曜日の午前10時に '123 Main St' という場所の歯科予約を追加"
"'キャンセル済みの会議' という会議を削除"

リマインダー管理

"未完了のリマインダーをリスト表示"
"買い物リストのすべてのリマインダーを表示"
"リマインダーを追加: 牛乳を買う"
"明日の午後5時に母に電話するリマインダーを作成"
"'牛乳を買う' を完了済みとしてマーク"
"食料品に関するリマインダーを削除"

高度な機能 (v0.3.0以降)

"'会議' を含むイベントを検索"
"'プロジェクト' と 'レビュー' の両方を含むイベントを検索"
"今日の予定は何ですか？"
"今週の予定を表示"
"午後2時から3時に会議を予定すると、衝突はありますか？"
"今後3週間の毎週のチーム会議を3つ作成"
"歯科予約をワークカレンダーにコピー"
"'古いカレンダー' から '新しいカレンダー' にすべてのイベントを移動"
"すべてのキャンセル済みのイベントを削除"
"'IDOL' と 'Idol' カレンダー間の重複イベントを検索"

DXの改善 (v1.0.0)

"次の5つの予定イベントを表示"
→ list_events(start_date: "2026-02-06", end_date: "2026-12-31", filter: "future", sort: "asc", limit: 5)

"期限切れのリマインダーを表示"
→ list_reminders(filter: "overdue")

"'古いカレンダー' から2025年より前のイベントを削除する前に、どのイベントが削除されるかをプレビュー"
→ delete_events_batch(calendar_name: "Old Calendar", before_date: "2025-01-01", dry_run: true)

"午後2時にイベントを作成" (完全なISO8601形式は必要ありません！)
→ create_event(start_time: "14:00", end_time: "15:00", ...)

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

macOSカレンダーアプリに同期された任意のカレンダーで動作します。

• iCloudカレンダー
• Googleカレンダー
• Microsoft Outlook/Exchange
• CalDAVカレンダー
• ローカルカレンダー

同名カレンダーの曖昧性解消 (v0.6.0以降)

異なるソースから同名のカレンダーがある場合 (例: iCloudとGoogleの両方に "Work" カレンダーがある)、calendar_source パラメータを使用します。

"iCloudのワークカレンダーにイベントを作成"
→ create_event(calendar_name: "Work", calendar_source: "iCloud", ...)

"Googleのワークカレンダーのイベントを表示"
→ list_events(calendar_name: "Work", calendar_source: "Google", ...)

曖昧性が検出された場合、エラーメッセージにすべての利用可能なソースが表示されます。

トラブルシューティング

🔧 技術詳細

• 現在のバージョン: v1.3.1
• フレームワーク: MCP Swift SDK v0.11.0
• カレンダーAPI: EventKit (ネイティブmacOSフレームワーク)
• トランスポート: stdio
• プラットフォーム: macOS 13.0以上 (Ventura以降)
• ツール: カレンダー、イベント、リマインダー、タグ、および高度な操作のための25のツール

バージョン履歴

コントリビュート

コントリビューションは大歓迎です！プルリクエストを送信してください。

📄 ライセンス

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

作者

Che Cheng (@kiki830621) によって作成されました。

このプロジェクトが役に立った場合は、スターをつけていただけると幸いです！