Google Calendar MCP Server

Google Calendar APIを使用したMCP（Model Context Protocol）サーバーです。FastMCPフレームワークを使用してGoogleカレンダーの操作機能を提供します。

機能

• カレンダー一覧取得: 利用可能なGoogleカレンダーの一覧を取得
• イベント取得: 指定したカレンダーからイベントを取得
• イベント作成: 新しいカレンダーイベントを作成
• イベント削除: カレンダーイベントを削除

要件

• Python 3.12以上
• Google Cloud Platformプロジェクト
• Google Calendar API有効化
• OAuth2認証情報

インストール

1. リポジトリをクローン

git clone <repository-url>
cd google-calendar-mcp

2. 依存関係をインストール

pip install -e .

またはuvを使用する場合:

uv sync

設定

1. Google Cloud Platform設定

1. Google Cloud Consoleでプロジェクトを作成
2. Google Calendar APIを有効化
3. OAuth2認証情報を作成
4. 必要な環境変数を設定

2. 環境変数設定

以下の環境変数を設定してください:

export GOOGLE_CLIENT_ID="your_client_id"
export GOOGLE_CLIENT_SECRET="your_client_secret"
export GOOGLE_PROJECT_ID="your_project_id"
export GOOGLE_REFRESH_TOKEN="your_refresh_token"

または.envファイルに設定:

GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret
GOOGLE_PROJECT_ID=your_project_id
GOOGLE_REFRESH_TOKEN=your_refresh_token

3. OAuth2認証情報の取得

1. Google Cloud ConsoleでOAuth2認証情報を作成
2. 認証フローを実行してリフレッシュトークンを取得
3. 取得した値を環境変数に設定

使用方法

MCPサーバーとして実行

python main.py

直接実行

python -m src.google_calendar_mcp

API仕様

list_calendars()

利用可能なGoogleカレンダーの一覧を取得します。

引数: なし

戻り値:

• success (bool): 処理が成功したかどうか
• calendars (List[Dict]): カレンダー情報のリスト
• count (int): カレンダー数
• error (str): エラーメッセージ（失敗時）

get_events()

指定したカレンダーからイベントを取得します。

引数:

• calendar_id (str): カレンダーID（デフォルト: 'primary'）
• time_min (str): 開始時刻（ISO形式、デフォルト: 現在時刻）
• time_max (str): 終了時刻（ISO形式、デフォルト: 7日後）
• max_results (int): 最大取得件数（デフォルト: 10）

戻り値:

• success (bool): 処理が成功したかどうか
• events (List[Dict]): イベント情報のリスト
• count (int): イベント数
• error (str): エラーメッセージ（失敗時）

create_event()

新しいカレンダーイベントを作成します。

引数:

• summary (str): イベントタイトル（必須）
• start_time (str): 開始時刻（ISO形式、必須）
• end_time (str): 終了時刻（ISO形式、必須）
• description (str): イベントの説明（デフォルト: ''）
• location (str): 場所（デフォルト: ''）
• calendar_id (str): カレンダーID（デフォルト: 'primary'）
• attendees (List[str]): 参加者メールアドレスのリスト（デフォルト: None）

戻り値:

• success (bool): 処理が成功したかどうか
• event_id (str): 作成されたイベントのID
• event_link (str): イベントのGoogleカレンダーリンク
• message (str): 成功メッセージ
• error (str): エラーメッセージ（失敗時）

delete_event()

カレンダーイベントを削除します。

引数:

• event_id (str): 削除するイベントのID（必須）
• calendar_id (str): カレンダーID（デフォルト: 'primary'）

戻り値:

• success (bool): 処理が成功したかどうか
• message (str): 成功メッセージ
• error (str): エラーメッセージ（失敗時）

テスト

モックモードでのテスト実行

python run_tests.py --mode mock

実際のAPIを使用したテスト実行

python run_tests.py --mode real_api

カバレッジレポート付きテスト実行

python run_tests.py --mode mock --coverage

特定のテスト実行

python run_tests.py --mode mock --test test_calendar_tools.py::TestListCalendars

プロジェクト構造

google-calendar-mcp/
├── src/
│   ├── __init__.py
│   ├── google_calendar_mcp.py    # MCPサーバーのメインエントリーポイント
│   ├── auth/
│   │   ├── __init__.py
│   │   └── google_auth.py        # Google認証処理
│   └── tools/
│       ├── __init__.py
│       └── calendar_tools.py     # カレンダー操作機能
├── tests/
│   ├── __init__.py
│   └── test_calendar_tools.py    # テストコード
├── main.py                       # アプリケーションエントリーポイント
├── run_tests.py                  # テスト実行スクリプト
├── pyproject.toml                # プロジェクト設定
├── pytest.ini                   # pytest設定
└── README.md                     # このファイル

依存関係

• fastmcp: MCPサーバーフレームワーク
• google-api-python-client: Google APIクライアント
• google-auth-httplib2: Google認証ライブラリ
• google-auth-oauthlib: OAuth2認証ライブラリ
• python-dotenv: 環境変数管理
• pytest: テストフレームワーク
• pytest-mock: モックテストライブラリ

ライセンス

このプロジェクトのライセンスについては、LICENSEファイルを参照してください。

貢献

プルリクエストやイシューの報告を歓迎します。

トラブルシューティング

認証エラー

• 環境変数が正しく設定されているか確認
• OAuth2認証情報が有効か確認
• Google Calendar APIが有効化されているか確認

権限エラー

• 必要なスコープが設定されているか確認
• カレンダーへのアクセス権限があるか確認

テストエラー

• 環境変数USE_REAL_APIの設定を確認
• 必要な依存関係がインストールされているか確認