Google MCP

OpenBSP MCP for Google Workspace

AI アシスタントが Google Calendar と Sheets にアクセスできる、公開 Model Context Protocol（MCP）サーバーです。

公開中：https://g.mcp.openbsp.dev

このプロジェクトの目的

ほとんどの Google MCP サーバーでは、独自の Google Cloud プロジェクトを作成し、OAuth 認証情報を設定して、ローカルサーバーを実行する必要があります。これは手間がかかり、エラーも発生しやすい作業です。

このプロジェクトは異なります。 OAuth プロキシ機能を備えた、ホスト型の公開サーバーです。必要なのは次の操作だけです。

1. 「Login with Google」をクリックします
2. API キーを取得します
3. MCP クライアントに追加します

Google Cloud の設定も、ローカルサーバーも、環境変数も不要です。接続するだけです。

できること

接続後、AI アシスタントに次の操作を依頼できます。

• カレンダーの予定を一覧表示して検索する
• 予定を作成、更新、削除する
• Google Sheets のデータを読み書きする
• 新しいスプレッドシートを作成する

仕組み

┌──────────────┐     ┌──────────────────┐     ┌──────────────┐
│  AI Client   │────▶│  OpenBSP MCP     │────▶│  Google APIs │
│  (Claude)    │◀────│  Server          │◀────│              │
└──────────────┘     └──────────────────┘     └──────────────┘

1. 接続する Google サービス（Calendar、Sheets）を選択します
2. Google で認証し、権限を付与します
3. MCP クライアントの設定に使用する API キーを受け取ります
4. AI アシスタントが Google のデータにアクセスできるようになります

プライバシーとセキュリティ

保存するデータ

データ	目的	保護
API Key	MCP クライアントの認証	そのまま保存（ランダムな 256 ビット値）
OAuth Tokens	Google API への代理アクセス	AES-256-GCM で暗号化
Scopes	許可したサービスの記録	暗号化なし

OAuth トークンは、保存時に AES-256-GCM で暗号化されます。暗号化キーはデータベースとは別に保存されるため、データベースが侵害されただけでは Google のトークンは漏えいしません。

保存しないデータ

• Google のパスワード
• メールの内容
• カレンダーの予定やスプレッドシートのデータ
• 個人情報

データの保持期間

• API キー：取り消されるまで保存されます（有効期限が設定されている場合は、その期限まで）
• OAuth トークン：API キーとともに保存されます
• 一時的な認証状態：10 分後に削除されます

アクセスを取り消す方法

方法 1：API キーを削除する

curl -X DELETE https://g.mcp.openbsp.dev/key/YOUR_API_KEY

方法 2：Google から取り消す

1. Google Account Security にアクセスします
2. 一覧から「OpenBSP MCP」を見つけます
3. 「Remove Access」をクリックします

どちらの方法でも、API キーは直ちに無効になります。

MCP クライアントのセットアップ

認証後、次の内容を MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "google-mcp": {
      "url": "https://g.mcp.openbsp.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

プログラムによる連携

MCP クライアントは、ユーザーを次の URL にリダイレクトすることでセットアップを自動化できます。

https://g.mcp.openbsp.dev/auth/google?products=calendar,sheets&callback=YOUR_CALLBACK_URL

認証後、URL フラグメントに認証情報を含めた状態で、ユーザーは設定したコールバック先にリダイレクトされます。

YOUR_CALLBACK_URL#api_key=gmc_xxx&url=https://g.mcp.openbsp.dev/mcp&[email protected]&files=Budget.xlsx,Sales.xlsx

パラメーター	説明
api_key	生成された API キー
url	MCP エンドポイントの URL
email	アクセスを許可した Google アカウントのメールアドレス
files	カンマ区切りのファイル名（Sheets を許可し、ファイルを選択した場合のみ）

利用可能なツール

Calendar

要求するスコープ：

• calendar.events - 予定の読み取りと書き込み
• calendar.calendarlist.readonly - カレンダーの一覧表示（読み取り専用）

ツール	説明
list_calendars	すべてのカレンダーを一覧表示します
list_events	日付フィルターを指定して予定を取得します
check_availability	予定の詳細を公開せずに、空き時間と予定ありの時間を確認します
create_event	新しいカレンダーの予定を作成します
update_event	既存の予定を更新します
delete_event	予定を削除します

Sheets

要求されるスコープ：

• drive.file - 選択したファイル、またはアプリで作成したファイルのみにアクセスします

ツール	説明
list_authorized_files	ユーザーがアクセスを許可したファイルを一覧表示します
get_spreadsheet	スプレッドシートのメタデータ、シート、テーブルを取得します
get_sheet_schema	列名と推定される型を取得します
describe_sheet	すべての列の統計的な概要を取得します
search_rows	フィルター条件に一致する行を検索します
semantic_search	行を対象とした AI 搭載のセマンティック検索を行います（完全一致ではなく、意味に基づいて検索します）
read_sheet	範囲（例：「A1:D10」）からデータを読み取ります
write_sheet	範囲にデータを書き込みます
append_rows	行を追加します（フッターを考慮した追加に対応する tableId を指定できます）
create_spreadsheet	新しいスプレッドシートを作成します

drive.file スコープでは、認証中にユーザーが明示的に選択したファイル（Google Drive Picker 経由）、またはアプリで作成したファイルのみにアクセスできます。利用可能なスプレッドシートを確認するには、list_authorized_files を使用してください。

テーブルのサポート： get_spreadsheet ツールは、tableId を含むテーブルのメタデータを返します。フッターを考慮し、テーブルを自動的に拡張する適切なテーブル対応の追加を行うには、これを append_rows に渡してください。

セマンティック検索： semantic_search ツールは AI の埋め込み表現を使用して、意味に基づいて行を検索します。TAG によって提供されています。

セルフホスティング

独自のインスタンスを実行しますか？手順については DEPLOY.md をご覧ください。

よくある質問

これは公式ですか？ いいえ。これは独立したオープンソースプロジェクトであり、Google や Anthropic とは提携していません。

安全ですか？ 必要最小限の権限のみを要求します。データはサーバーを介して Google とお使いの AI クライアント間で直接やり取りされ、保存やログ記録は行いません。

コードを確認できますか？ はい！このプロジェクトはオープンソースです。コードを確認したり、独自のインスタンスを実行したり、改善に貢献したりできます。

API キーを紛失した場合はどうなりますか？ 再度認証して新しいキーを生成してください。古いキーは、取り消さない限り有効なままです。

費用はかかりますか？ この公開インスタンスは無料です。セルフホストする場合は、Cloudflare Workers の料金がかかります（十分な無料枠を利用できます）。