google-calendar-mcp-serviceaccount

AIエージェントに1つのGoogle Calendarへの読み書きアクセスを提供する最小限のMCPサーバーです。インタラクティブなOAuthではなく、サービスアカウントとして認証されます。

サービスアカウントを使う理由

ほとんどのGoogle Calendar MCPサーバーはOAuthを使用します。アプリは人間にサインインして同意を求める、実際のマルチユーザー製品と同じ方法です。自分のカレンダーにのみアクセスする必要があるパーソナルアシスタントにとって、それは必要な作業以上の儀式です — 本番環境への公開、検証済みドメイン、定期的な再同意。

サービスアカウントはそのすべてをスキップします。サービスアカウントのメールアドレスとカレンダーを共有するだけで、他の人と共有するのとまったく同じです。資格情報は、取り消すまで期限切れになりません。

トレードオフ: メールで明示的に共有できるカレンダー（個人のGoogleアカウント、ほとんどのWorkspace設定）でのみ機能します。完全なOAuth許可のように、ユーザーのアカウント全体に広く作用することはできません。

コスト: この記事の執筆時点では、以下の設定はすべて無料です。Google Cloudプロジェクトに請求先アカウントやクレジットカードを関連付ける必要はありません。Calendar APIの無料枠は、パーソナルアシスタントが使用する量をはるかに超えています。これは将来変更される可能性があります。不明な場合は、現在のGoogle Cloudの料金を確認してください。

Related MCP server: Google Calendar MCP Server

ツール

意図的にdelete_eventはありません。カレンダーエントリを削除できるエージェントが必要な場合は、自分で追加してください。

セットアップ

AIコーディングアシスタントの助けを借りて設定しますか？ AGENTS.mdを参照してください。人間側とエージェント側の両方の完全なステップバイステップが含まれています。

手動で行う場合：

1. Google Cloud Consoleでプロジェクトを作成し、Calendar APIを有効にし、サービスアカウント（OAuthクライアントではない）を作成し、そのJSONキーをダウンロードします。

2. サービスアカウントのメールアドレスとGoogle Calendarを共有し、「イベントを変更」権限を付与します。カレンダーのIDをメモします。自分のプライマリカレンダーの場合、これは単に自分のメールアドレスです。他のカレンダーの場合は、そのカレンダーの設定 → 「カレンダーを統合」 → 「カレンダーID」で確認できます。

3. python3 -m venv venv && ./venv/bin/pip install -r requirements.txt

4. .env.exampleを.envにコピーし、キーのパスとカレンダーIDを入力します。

5. calendar_server.pyをMCPクライアントにstdioサーバーとして登録し、それらの2つの変数を環境として渡します。

ライセンス

MIT — LICENSE を参照してください。