CalendarMCP

CalendarMCP

ホスト型の Google Calendar MCP サーバーです。 約2分で、あらゆる AI エージェントを Google Calendar に接続できます。セルフホストも、Docker も、credentials.json も不要です。

これは何ですか

CalendarMCP は、Google Calendar 用のホスト型 Model Context Protocol（MCP）サーバーです。Google アカウントを一度接続して API キーを取得すれば、MCP 対応クライアント（Claude Desktop、Claude Code、Claude.ai、Cursor、OpenClaw、Continue、Cline、Windsurf、Goose、Zed、ChatGPT カスタム GPT、n8n など）からカレンダーの読み書きができます。

このリポジトリは、サービスの公開ドキュメント、マニフェスト、クライアントのサンプルを提供します。ホスト型サービスはオープンソースではありません。 セルフホスト型の代替手段をお探しの場合、最も人気のある OSS オプションは nspady/google-calendar-mcp です。OAuth トークンを自身のマシンから一切外部に出したくないユーザーにおすすめします。

セルフホスト型 MCP にはない CalendarMCP の特長

• セットアップ不要。 Google OAuth をワンクリックするだけです。credentials.json、Google Cloud Console、Docker は不要です。
• HTTP トランスポート。 Claude.ai、Claude Code、Cursor、その他あらゆるホスト型 MCP クライアントで動作します。セルフホスト型の stdio MCP は Claude Desktop でしか動作しません。
• 一括操作。 batch_update_events では、1回の並行呼び出しで最大50件のイベントを更新できます。1年分の定例会議の名前変更も、50回クリックする代わりに1つのプロンプトで実行できます。
• 1つのキーで複数アカウントを利用。 OAuth とサービスアカウント共有カレンダーを組み合わせて、任意の数の Google アカウントを1つの API キーに接続できます。読み取り時にはすべてのアカウントに対して処理を行い、結果を統合して並べ替えます。
• Google Advanced Protection に対応。 GAP ユーザーが利用できる唯一のホスト型 MCP です（サービスアカウント共有を使用します。対象アカウントでは OAuth がブロックされます）。
• カレンダーごとの読み取り／書き込み設定。 ダッシュボードから各エージェントがアクセスできる範囲を制限でき、新しいキーを発行する必要はありません。

クイックスタート

1. calendarmcp.ai にアクセスし、Google でサインインして API キーをコピーします。
2. 任意のクライアントに MCP サーバーを追加します。設定例は以下のとおりです。
3. エージェントに「火曜日の予定は何ですか？」と聞いてみましょう。

クライアントの設定

お使いの MCP クライアントに応じた設定ファイルに、以下を追加してください。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "calendar": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/server-fetch",
        "https://calendarmcp.ai/api/mcp"
      ],
      "env": {
        "MCP_AUTH_HEADER": "Authorization: Bearer YOUR_CALENDARMCP_API_KEY"
      }
    }
  }
}

examples/claude-desktop.json と Claude Desktop 統合ガイド をご覧ください。

Claude Code

claude mcp add calendar https://calendarmcp.ai/api/mcp \
  --transport http \
  --header "Authorization: Bearer YOUR_CALENDARMCP_API_KEY"

examples/claude-code.sh と Claude Code 統合ガイド をご覧ください。

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "calendar": {
      "url": "https://calendarmcp.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_CALENDARMCP_API_KEY"
      }
    }
  }
}

examples/cursor.json と Cursor 統合ガイド をご覧ください。

OpenClaw

openclaw.json に追加します：

{
  "plugins": {
    "entries": {
      "mcp-calendarmcp": {
        "enabled": true,
        "config": {
          "url": "https://calendarmcp.ai/api/mcp",
          "authHeader": "Bearer YOUR_CALENDARMCP_API_KEY"
        }
      }
    }
  }
}

examples/openclaw.json と OpenClaw 統合ガイド をご覧ください。

その他のクライアント

Continue、Windsurf、Goose、n8n などの設定例は examples/ をご覧ください。

ツール

CalendarMCP は 11 個のツールを公開しています。機械可読なスキーマの全容は、https://calendarmcp.ai/api/docs にあります。

ツール	説明
list_events	指定した期間内の、接続済みカレンダーの一部またはすべての予定を一覧表示します。最大 2500 件まで自動でページネーションします。
get_event	1 件の予定の詳細を取得します。
create_event	予定を作成します。参加者、場所、リマインダー、繰り返し、終日の予定に対応しています。
update_event	既存の予定を部分的に更新します。
delete_event	予定を削除します。
quick_add_event	自然言語（「金曜日の午後 1 時に Sam とランチ」など）から予定を作成します。
list_calendars	API キーからアクセスできるすべてのカレンダーを、カレンダーごとの読み書き権限とともに一覧表示します。
find_free_time	1 つ以上のカレンダーの空き時間／予定あり状況を照会します。二重予約を防ぐため、create_event の前に呼び出すのがおすすめです。
manage_attendees	予定の参加者を追加または削除します。
batch_update_events	1 回の並行呼び出しで最大 50 件の予定を更新します。

リファレンス全編：docs/tools.md。

認証

API キーはダッシュボード（calendarmcp.ai/dashboard）から発行できます。1 つのキーに、任意の数の Google アカウントを接続できます。カレンダーごとの読み書きスコープはサーバー側で適用されます。

レート制限：キーごとに 1 分あたり 60 リクエスト。無料プランを提供しています。より高い上限の従量課金プランは近日公開予定です。

docs/authentication.md をご覧ください。

Google Advanced Protection

Google Advanced Protection を有効にしている場合、Google のポリシーにより、サードパーティ製カレンダーアプリへの OAuth がブロックされます。CalendarMCP は、GAP を利用しているユーザー向けに、サービスアカウント共有フローをサポートしています。私たちが把握している限り、これに対応するホスト型 MCP は当サービスだけです。

docs/google-advanced-protection.md をご覧ください。

ロードマップ

• ✅ Google Calendar（提供中）
• ⏳ Microsoft Outlook Calendar（ウェイトリスト）
• ⏳ iCloud Calendar（ウェイトリスト）
• ⏳ CalDAV（任意のプロバイダー）

料金

手厚い上限の無料プランを提供しています。ヘビーユーザー向けの有料プランも近日公開予定です。

calendarmcp.ai/pricing をご覧ください。

比較

機能	CalendarMCP	nspady（OSS）	Composio	Zapier MCP
ホスト型	✅	❌	✅	✅
HTTP トランスポート	✅	❌（stdio のみ）	✅	✅
セットアップ時間	2 分	25 分	10 分	5 分
予定の一括更新	✅	❌	❌	❌
1 つのキーで複数アカウント	✅	❌	❌	❌
Google Advanced Protection	✅	❌	❌	❌
カレンダーごとの読み書き権限一覧	✅	❌	❌	❌
オープンソース	❌	✅	一部	❌
トークンを自分のマシンに保存	❌	✅	❌	❌

率直に言うと、Claude Desktop だけを使っていて、サードパーティを一切利用したくない場合は nspady をお選びください。それ以外の場合は CalendarMCP をお選びください。

コントリビュート

このリポジトリにはドキュメントとサンプルが含まれています。以下に関する PR を歓迎します。

• 新しいクライアント設定のサンプル
• ドキュメントの改善と説明の明確化
• 翻訳

サービスに関する問題（バグ、ホスト型製品の機能リクエスト）→ GitHub Issues。

ライセンス

このリポジトリのサンプルとドキュメント：MIT（LICENSE をご覧ください）。

ホスト型サービスはオープンソースではありません。

リンク

• calendarmcp.ai。サービス
• ドキュメント
• ブログ
• 変更履歴
• 連携サービス
• ユースケース