MCP 経由で Google Sheets を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Google Sheets をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Google Sheets + Gemini

AI に Google Sheets で作業させます。任意の範囲や複数の範囲の一括読み取り、スプレッドシートのシートとサイズの確認、表への行の追加、セルや数式の書き込みと更新、スプレッドシートの作成、シートの追加と名前の変更ができます。個人の Google アカウントと Google Workspace に対応しています。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

ステップ 1 — 認証情報を取得

1. console.cloud.google.com を開き、プロジェクトを選択または作成してから、APIs & Services → Library で Google Sheets API を有効にします。
2. APIs & Services → OAuth consent screen を開きます。Google Workspace を使っている場合は Internal（最も簡単です）、それ以外は External を選びます。External の場合は公開ステータスを In production にしてください。アプリが Testing のままだと、Google は 7 日後にリフレッシュトークンを取り消し、コネクターは毎週動かなくなります。自分のアカウントで使うだけなら、「unverified app」の警告はそのまま先に進んで構いません。
3. APIs & Services → Credentials → Create credentials → OAuth client ID を開き、アプリケーションの種類に Web application を選んで、承認済みのリダイレクト URI に https://cloud.anythingmcp.com/api/mcp-oauth/callback を追加します。AnythingMCP をセルフホストしている場合は、代わりに https://your-anythingmcp-host/api/mcp-oauth/callback を入力します。
4. クライアント ID を GOOGLE_CLIENT_ID に、クライアントシークレットを GOOGLE_CLIENT_SECRET に貼り付けて、コネクターをインストールします。
5. コネクターのページで Authorize with Provider をクリックし、AI に使わせたいスプレッドシートの Google アカウントでサインインします。リフレッシュトークンは暗号化して保存され、アクセストークンは自動的に更新されます。

すべての Google コネクターに 1 つの Google クライアント: 同じ Cloud プロジェクトと OAuth クライアントで、Gmail、Google Calendar、Google Drive、Google Sheets、Google Docs、Google Tasks、Search Console、Analytics、Ads のすべての Google コネクターを使えます。そのプロジェクトで各 API を有効にし、同じクライアント ID とシークレットを使い回して、コネクターごとに一度ずつ承認してください。各コネクターは自分に必要な権限だけを求めます。

スプレッドシートの見つけ方: スプレッドシートのリンクをチャットに貼り付けてください。ID は https://docs.google.com/spreadsheets/d/<id>/edit の長い文字列です。名前でスプレッドシートを探したい場合は、Google Drive コネクターも追加します。値は手で入力したのと同じように書き込まれるので、数値、日付、=SUM(B2:B20) のような数式も使えます。新しい行は表の最終行の後に追加され、その下のデータは上書きされません。

権限: コネクターは https://www.googleapis.com/auth/spreadsheets を求めます。あなたのアカウントで開けるすべてのスプレッドシートの読み書きです。Google Drive は含まれないため、スプレッドシートのファイルを一覧表示、検索、移動、共有することはできません。

読み取り専用の設定: コネクターの OAuth 設定でスコープを https://www.googleapis.com/auth/spreadsheets.readonly に変更し、もう一度承認してから、gsheets_append_rows、gsheets_update_range、gsheets_batch_update_values、gsheets_create_spreadsheet、gsheets_add_sheet、gsheets_rename_sheet を無効にします。

インストール時はオフ: gsheets_clear_range と gsheets_batch_update（シート、行、列を削除できます）。AI に必要な場合はツールごとにオンにしてください。

よくあるエラー: 401 は承認の期限切れまたは取り消しを示します（同意画面が Testing のままだと 7 日後に必ず起きます）。もう一度 Authorize with Provider をクリックしてください。403 PERMISSION_DENIED は、そのスプレッドシートをアカウントで開けないか編集できない、またはスコープが読み取り専用であることを示します。403「Sheets API has not been used in project」は、Cloud プロジェクトで Google Sheets API が有効になっていないことを示します。400 Unable to parse range は、シート名のつづりが違うか、'売上 2026'!A:C のように単一引用符で囲む必要があることを示します。

このコネクターはスプレッドシートのファイルの検索、共有、移動、削除は行わず（それは Google Drive コネクターの役割です）、Apps Script も実行しません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Google Sheets のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「このスプレッドシートの「注文」シートを読んで、合計額が大きい顧客を上位 5 社挙げて。」
• 「今日の経費を経費シートに新しい行として追加して。日付、内容、金額。」
• 「「集計」シートを追加して、月別の合計と最終行に SUM の数式を入れて。」
• 「イベントの招待客リスト用に、名前、メール、会社、ステータスの列がある新しいスプレッドシートを作って。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続