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. リポジトリをクローン

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

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

設定

1. Google Cloud Platform設定

1. Google Cloud Consoleでプロジェクトを作成

2. Google Calendar APIを有効化

3. OAuth2認証情報を作成

4. 必要な環境変数を設定

2. 環境変数設定

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

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

3. OAuth2認証情報の取得

1. Google Cloud ConsoleでOAuth2認証情報を作成

2. 認証フローを実行してリフレッシュトークンを取得

3. 取得した値を環境変数に設定

使用方法

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): エラーメッセージ（失敗時）

テスト

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

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

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

特定のテスト実行

プロジェクト構造

依存関係

• 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の設定を確認

• 必要な依存関係がインストールされているか確認