Google Sheets MCP Server（mcp-gsheets）

Google Sheets とは

Google Sheets（Google スプレッドシート）は、Google が提供する Web ブラウザで使えるスプレッドシート（表計算）ツールです。Excel と同じく「表計算で業務を回す」用途で広く使われていますが、インストール不要・複数人でリアルタイム共同編集できる点が最大の特徴です。なお、Excel ファイル（xlsx / xlsm）そのものを直接読み書きしたい場合は、Excel 本体のインストール不要で操作できる excel-mcp-server が適しています。

スタートアップから大企業まで広く採用されており、Google Workspace の中核ツールとして、売上集計・在庫管理・予算管理・タスク追跡・顧客リスト管理など、業務データの共有・更新の場として定着しています。Google Drive 上に保存されるため、Drive の検索や共有機能と一体化して動作します。

これは公式提供ではなく、有志が作った非公式ツールです。

Google Sheets × AI でできること

この MCP サーバーを導入すると、Google スプレッドシートの操作を AI への一言で実行できます。

📖 範囲読み取り

「『売上』シートの A1〜D10 を読み取って」
→ シート範囲の値取得

➕ 行追加

「『顧客リスト』の最終行に山田太郎の情報を追加」
→ 自動 append

📊 集計 + 書式設定

「月別売上合計を計算してヘッダーを太字に」
→ 数式 + 書式適用

📈 グラフ作成

「Q1 売上から折れ線グラフを作って」
→ create_chart で自動生成

提供される主なツール

Google Sheets MCP Server（mcp-gsheets）が公式に提供する主な機能領域:

機能カテゴリ	主なツール
値の読み書き	sheets_get_values / sheets_update_values / sheets_append_values / sheets_clear_values / sheets_batch_update_values
シート構造	シート作成・削除・名前変更・複製
書式設定	フォント・色・罫線・配置・条件付き書式
セル結合	merge / unmerge / 結合範囲取得
行・列操作	行の挿入・行 / 列の削除
チャート	折れ線 / 棒 / 円グラフなどの作成
データ検証	入力規則・データ範囲制約の取得（読み取り）
メタデータ	スプレッドシート構造・シート一覧・プロパティ取得

API 実装名について: 個別のツール名は公式リポジトリ でご確認ください。Google Sheets API v4 の主要機能を網羅しています。

Google Sheets MCP Server について

Google Sheets MCP Server（mcp-gsheets）は、freema 氏（Tomáš Grásl）が公開するコミュニティメンテ版 MCP サーバーです。Google 社の公式提供ではありません（Google 公式 Workspace MCP は Drive / Gmail / Calendar / Chat / People を個別の接続先 URL（エンドポイント）で提供しており、Sheets は本 MCP のようなコミュニティ実装で利用するのが現状）。

Google Cloud のサービスアカウント（JSON 鍵）で認証するため、OAuth 同意フローや個人アカウントの紐付けは不要です。自動化バッチや共有環境でも扱いやすい構成で、シートの読み取り・更新・行追加・書式設定・条件付き書式・チャート作成・シート構造取得など、50 種類のツールを備えています。

スペック

• 配布形態: npm パッケージ（mcp-gsheets）+ Node.js v20+
• 認証: Google Cloud サービスアカウント（JSON 鍵）
• 必須環境変数: GOOGLE_PROJECT_ID / GOOGLE_APPLICATION_CREDENTIALS
• 提供元: コミュニティ実装（freema/mcp-gsheets）/ MIT
• 対応 API: Google Sheets API v4
• 公式リポジトリ: github.com/freema/mcp-gsheets

導入手順

前提条件

• Node.js v20 以上
• Google アカウント
• Google Cloud Project で Google Sheets API を有効化済み

ステップ

1. Google Cloud Console でプロジェクトを作成（または既存を選択）し、プロジェクト ID をメモ
2. 「API とサービス」→「ライブラリ」から Google Sheets API を有効化
3. 「API とサービス」→「認証情報」→「認証情報を作成」→ サービスアカウントを作成
4. 作成したサービスアカウントの「鍵」タブ →「鍵を追加」→「新しい鍵を作成」→ JSON 形式でダウンロード
5. 操作したいスプレッドシートを開き、右上の「共有」から上記サービスアカウントの メールアドレスを招待（「編集者」権限）
6. ページ上部のタブから使用環境を選択し、JSON 設定をコピー
7. your-project-id をプロジェクト ID に、/absolute/path/to/service-account-key.json を手元の JSON 鍵ファイルの 絶対パスに置き換え
8. 設定ファイル（claude_desktop_config.json など）に追記して保存し、クライアントを再起動

注意事項

• サービスアカウントの JSON 鍵はパスワード相当の秘匿情報です。公開リポジトリや共有ストレージへのコミットは厳禁。.gitignore で保護し、必要なら Secret Manager 等への移行も検討してください。
• アクセスできるのは、サービスアカウントが明示的に共有されているスプレッドシートのみです。組織内共有やリンク共有の設定では届かないので、都度「共有」ダイアログからサービスアカウントのメールを招待してください。
• Google Sheets API には 1 分あたり・1 日あたりのリクエスト制限があります。大量の行操作はバッチ系ツール（sheets_batch_update_values 等）の活用を推奨。
• 本 MCP は Anthropic / Google が公式提供するものではなく、コミュニティメンテ版です。機能追加・不具合修正は GitHub リポジトリ の開発ペースに依存します。
• Google Sheets は Google LLC の登録商標です。本ツールは Google 社公式の製品ではありません。

{
  "mcpServers": {
    "mcp-gsheets": {
      "command": "npx",
      "args": ["-y", "mcp-gsheets@latest"],
      "env": {
        "GOOGLE_PROJECT_ID": "your-project-id",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account-key.json"
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-gsheets": {
      "command": "npx",
      "args": ["-y", "mcp-gsheets@latest"],
      "env": {
        "GOOGLE_PROJECT_ID": "your-project-id",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account-key.json"
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-gsheets": {
      "command": "npx",
      "args": ["-y", "mcp-gsheets@latest"],
      "env": {
        "GOOGLE_PROJECT_ID": "your-project-id",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account-key.json"
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-gsheets": {
      "command": "npx",
      "args": ["-y", "mcp-gsheets@latest"],
      "env": {
        "GOOGLE_PROJECT_ID": "your-project-id",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account-key.json"
      }
    }
  }
}

[mcp_servers.mcp-gsheets]
command = "npx"
args = ["-y", "mcp-gsheets@latest"]

[mcp_servers.mcp-gsheets.env]
GOOGLE_PROJECT_ID = "your-project-id"
GOOGLE_APPLICATION_CREDENTIALS = "/absolute/path/to/service-account-key.json"

{
  "servers": {
    "mcp-gsheets": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-gsheets@latest"
      ],
      "env": {
        "GOOGLE_PROJECT_ID": "your-project-id",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account-key.json"
      }
    }
  }
}