Google Spreadsheet MCP Server

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

機能

データ操作

ツール	説明
get_sheet_metadata	スプレッドシートのタイトルとシート（タブ）一覧を取得
read_values	指定範囲のデータを読み込み
append_values	指定範囲の末尾にデータを追記
update_values	指定範囲のデータを上書き更新

シート管理

ツール	説明
add_sheet	新しいシート（タブ）を追加
delete_sheet	シート（タブ）を削除
rename_sheet	シート（タブ）の名前を変更

行列操作

ツール	説明
insert_rows	指定位置に空の行を挿入
insert_columns	指定位置に空の列を挿入
delete_rows	指定範囲の行を削除
delete_columns	指定範囲の列を削除

入力規則

ツール	説明
set_dropdown	ドロップダウンリストを設定（固定値）
set_dropdown_range	ドロップダウンリストを設定（セル範囲参照）
set_checkbox	チェックボックスを設定
get_validations	入力規則一覧を取得
delete_validation	指定範囲の入力規則を削除

条件付き書式

ツール	説明
add_conditional_format	カスタム数式による条件付き書式を追加
get_conditional_formats	条件付き書式ルール一覧を取得
delete_conditional_format	指定したインデックスの条件付き書式を削除

セットアップ

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

制限事項

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