Google Spreadsheet MCP Server

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

機能

データ操作

シート管理

行列操作

入力規則

条件付き書式

セットアップ

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列が「承認」の場合は行全体を緑色にして

制限事項

• 新規スプレッドシートの作成は非対応
• 書式設定はカスタム数式による条件付き書式のみ対応（フォント変更等は非対応）