icloud-calendar

iCloud Calendar MCP

iCloud Calendar を管理する MCP サーバーです。

英語 · 簡体字中国語

セットアップ

必要条件：

• Node.js 22.13 以降
• Apple Account のメールアドレス
• Apple のアプリ用パスワード

MCP クライアントにサーバーを追加します：

{
  "mcpServers": {
    "icloud-calendar": {
      "command": "npx",
      "args": ["-y", "icloud-calendar-mcp"],
      "env": {
        "ICLOUD_USERNAME": "[email protected]",
        "ICLOUD_APP_PASSWORD": "xxxx-xxxx-xxxx-xxxx"
      }
    }
  }
}

Apple Account のパスワードではなく、アプリ用パスワードを使用してください。

ツール

ツール	目的
list_calendars	カレンダーを一覧表示する
list_events	指定した期間のイベントを一覧表示する
get_event	イベントを取得する
create_event	イベントを作成する
update_event	イベントを更新する
delete_event	イベントを削除する
find_conflicts	重複するイベントを検索する
free_busy	予定ありの時間帯を返す

イベントには、タイムゾーン、終日の日付、繰り返しルール、アラーム、場所、説明、URL、参加者を含められます。

リクエスト例

サーバーに接続したら、MCP クライアントに次のように依頼できます：

カレンダーを表示してください。

来週、Asia/Shanghai の時刻でカレンダーに何が入っていますか？

明日の午後2時から3時まで、Work カレンダーにプロジェクトレビューを追加し、15分前にリマインダーを設定してください。

金曜日の午前9時から正午までに、予定の重複はありますか？

プロジェクトレビューを午後4時に移動し、場所を Meeting Room B に変更してください。

10月1日に「会社の休日」という終日イベントを追加してください。

プロジェクトレビューのイベントを削除してください。

依頼内容が曖昧な場合は、可能であればカレンダー、日付、時刻、タイムゾーンを指定してください。

動作

• 終日イベントの終了日は含まれません。8月18日の1日イベントでは、2026-08-18 から 2026-08-19 までを指定します。
• 作成、更新、削除の操作では、安全に再試行できるよう request_id を指定できます。
• 同時に行われた変更は ETag で検出します。
• 繰り返し予定のシリーズ全体を更新または削除できます。未対応の個別回の変更は、シリーズを変更せずエラーを返します。

入力、出力、エラーコードの詳細については、ツールの仕様を参照してください。

HTTP

デフォルトのトランスポートは stdio です。Streamable HTTP は任意で利用できます：

ICLOUD_MCP_TRANSPORT=http \
ICLOUD_MCP_HTTP_TOKEN='replace-with-a-long-random-token' \
ICLOUD_MCP_HTTP_PORT=3000 \
npx -y icloud-calendar-mcp

HTTP モードではベアラートークンが必要で、デフォルトではループバックで待ち受けます。プロキシ経由で公開する前に、セキュリティを確認してください。

開発

pnpm install
pnpm check

アーキテクチャ、コントリビューション、リリースを参照してください。

ライセンス

MIT