Google Spreadsheet MCP Server

Google スプレッドシートを操作するための MCP (Model Context Protocol) サーバーです。 Claude Code などの AI エージェントからスプレッドシートの読み書きが可能になります。

機能

データ操作

シート管理

行列操作

入力規則

条件付き書式

Related MCP server: gworkspace-mcp

セットアップ

1. GCP プロジェクト設定

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

2. Google Sheets API を有効化

   APIs & Services → Enable APIs → 「Google Sheets API」を検索 → 有効化

2. OAuth クライアント ID 作成

1. APIs & Services → Credentials → Create Credentials → OAuth client ID

2. アプリケーションの種類: ウェブアプリケーション

3. 名前を入力（例: sheets-mcp）

4. 承認済みのリダイレクトURI: http://localhost:8080/callback を追加

5. Create → JSON をダウンロード → credentials/client_secret.json として保存

3. ビルド

pnpm install
pnpm run build

4. Claude Code 設定

.mcp.json をプロジェクトルートに作成:

{
  "mcpServers": {
    "google-spreadsheet": {
      "command": "node",
      "args": ["/path/to/google-spreadsheet-mcp/dist/index.js"],
      "env": {
        "CLIENT_SECRET_PATH": "/path/to/credentials/client_secret.json",
        "TOKEN_PATH": "/path/to/credentials/token.json"
      }
    }
  }
}

5. 初回認証

初回起動時にブラウザが開き、Google アカウントでの認証を求められます。 認証後、トークンが TOKEN_PATH に保存され、以降は自動的に認証されます。

Note: 自分の Google アカウントで認証するため、既にアクセス権のあるスプレッドシートはすべて操作可能です。

使用例

シート情報を取得

https://docs.google.com/spreadsheets/d/xxx/edit のシート情報を取得して

データを読み込み

このスプレッドシートのシート1 A1:C10 を読み込んで

データを追記

シート1 に以下のデータを追加して:
- 山田, 25, エンジニア
- 佐藤, 30, デザイナー

データを更新

A1:B2 を以下に更新して:
- 名前, 年齢
- 田中, 28

シートを追加

「売上データ」という名前のシートを追加して

シートの名前を変更

シート1 を「顧客リスト」に名前変更して

ドロップダウンを設定

D列にドロップダウンを設定して。選択肢は「承認」「却下」「保留」

チェックボックスを設定

E列にチェックボックスを設定して

条件付き書式を追加

D列が「承認」の場合は行全体を緑色にして

制限事項

• 新規スプレッドシートの作成は非対応

• 書式設定はカスタム数式による条件付き書式のみ対応（フォント変更等は非対応）