Google Calendar MCP Server

🚀 Google Calendar MCP Server

Google Calendar MCP Serverは、Google CalendarのツールをMCP互換のクライアント（例：Claude Desktop、Cursor MCP CLI）に公開するサーバーです。以下の操作が可能です。

• 指定した時間範囲内のイベントを一覧表示する
• イベントを作成する
• イベントの概要に基づいてイベントを削除する

🚀 クイックスタート

✨ 主な機能

• 時間範囲内でのイベントの一覧表示
• イベントの作成
• イベント概要によるイベントの削除

📦 インストール

前提条件

• Python 3.11以上
• Google Calendar API用のOAuth 2.0クライアントID（デスクトップ）を持つGoogle Cloudプロジェクト
• ローカルにダウンロードされたcredentials.json（コミットしないでください）

セットアップ手順

1. リポジトリをクローンし、依存関係をインストールします。

uv sync  # または: pip install -e .

2. Google Calendar APIを有効にし、OAuth認証情報をダウンロードします。

• Google Cloud Console → APIとサービス → 認証情報にアクセスします。
• OAuthクライアントIDを作成します。アプリケーションの種類は「デスクトップアプリ」を選択します。
• JSONファイルをダウンロードし、プロジェクトのルートにcredentials.jsonとして保存します。

3. 初回実行時のOAuth承認 最初にツールを呼び出すと、ブラウザが開き、承認を求められます。その後、ローカルにtoken.jsonが生成されます（gitで無視されます）。

💻 使用例

MCPサーバーの起動

python -m src.service  # サーバーのエントリーポイントではありません
python main.py         # stdio経由でMCPを起動します

MCP互換のクライアントからは、コマンドとしてmain.pyを指定して使用します。

ツールの使用

• get_google_calendar_events(maxResults, calendarId="primary", singleEvents=True, orderBy="startTime", timeMin=None, timeMax=None)
  • 返り値は、[{ "title": str, "start-time": str, "end-time": str }]のようなリストです。
• create_google_calendar_event(summary, start: datetime, end: datetime, description=None, location=None, time_zone="Asia/Dhaka")
  • 作成されたイベントのHTMLリンクを返します（利用可能な場合）。
• delete_google_calendar_event(event_name: str)
  • 最初に一致する概要のイベントを削除します。

MCPクライアントの設定（例）

クライアント設定のJSONスニペットの例です。

{
  "mcpServers": {
    "google-calendar": {
      "command": "python",
      "args": ["main.py"],
      "env": {}
    }
  }
}

📚 ドキュメント

注意事項

• credentials.jsonとtoken.jsonはgitに含めないでください。
• 時間文字列は、タイムゾーン付きのRFC3339形式（例：2025-08-08T00:00:00+06:00）で指定する必要があります。
• 終日イベントの場合、date文字列が返され、dateTimeではありません。