Google Sheets

google-sheets-mcp

Google Sheets 用の MCP サーバーです。スプレッドシートのデータを読み取り、書き込み、クエリできます。

ユースケース

データに関する質問：「パイプラインにある未成立の案件はいくつですか？」や「第 3 四半期の売上合計はいくらですか？」→スプレッドシートを読み取り、直接回答します。

経費の簡単な記録：領収書の写真を撮ると、詳細を抽出して経費管理表に行を追加します。

複数ツール間でのステータス同期：「すべてのベンダーの Slack チャンネルを確認し、最新情報で管理用スプレッドシートを更新して」→Slack を読み取り、シートを更新します。

データ分析：「Salesforce の数値を地域別に分類し、イベントカレンダーと比較して」→複数のソースからデータをスプレッドシートに取り込み、分析します。

（これらはあくまで例です。スプレッドシートのデータが必要なワークフローであれば、どれでも利用できます。ファイルの検索、削除、コメント、共有権限の管理には、google-drive-mcp と組み合わせて使用してください。）

セットアップ

1. Google OAuth 認証情報を作成する

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成します（または既存のプロジェクトを使用します）
3. Google Sheets API を有効にします
4. APIs & Services → OAuth consent screen に移動し、同意画面を設定します
5. APIs & Services → Credentials → Create Credentials → OAuth client ID に移動します
6. Web application を選択します
7. Authorized redirect URIs に http://localhost:3000/callback を追加します
8. Client ID と Client Secret を控えます

2. サーバーを実行する

GOOGLE_CLIENT_ID='your-client-id' \
GOOGLE_CLIENT_SECRET='your-client-secret' \
MCP_TRANSPORT=http \
npm start

サーバーはデフォルトで http://localhost:3000 で実行されます。PORT=3001 で変更できます。

3. MCP クライアントに追加する

サーバーを実行した状態で、install-mcp の手順に従ってください。MCP クライアント（Claude Code、Claude Desktop、Cursor、Cline、VS Code など）に適した設定が生成されます。

アーキテクチャ

このサーバーは、Google への OAuth プロキシ として動作します。

graph LR
    A[MCP client] <--> B[google-sheets-mcp] <--> C[Google OAuth/API]

1. サーバーは /.well-known/oauth-authorization-server を通じて、OAuth 認可サーバーとして自身を通知します
2. /register は Google OAuth クライアントの認証情報を返します
3. /authorize はクライアントのコールバック URL を state にエンコードし、Google にリダイレクトします
4. /callback は Google からコードを受け取り、クライアントのコールバックに転送します
5. /token はクライアントの認証情報を追加して、Google へのトークンリクエストをプロキシします
6. /mcp は MCP リクエストを処理し、ベアラートークンを使用して Google Sheets API を呼び出します

サーバーはトークンも状態も保持せず、Google への OAuth をプロキシするだけです。

ツール

ツール	説明
スプレッドシート
sheets_spreadsheet_get	スプレッドシートのメタデータを取得します（タイトル、シート一覧、オプションでセルデータ）
sheets_spreadsheet_create	新しいスプレッドシートを作成します
値
sheets_values_get	範囲内のセル値を読み取ります
sheets_values_batch_get	複数の範囲からセル値を読み取ります
sheets_values_update	範囲内のセル値を書き込みます（上書き）
sheets_values_batch_update	複数の範囲にセル値を書き込みます
sheets_values_append	既存データの後に行を追加します
sheets_values_clear	範囲内のセル値を消去します
シート（タブ）
sheets_sheets_list	スプレッドシート内のすべてのシートを一覧表示します
sheets_sheet_add	新しいシート（タブ）を追加します
sheets_sheet_delete	シート（タブ）を削除します
高度な操作
sheets_batch_update	一括操作（書式設定、セル結合、フィルターなど）を実行します

Google Sheets API のスコープ

• spreadsheets - スプレッドシートへの完全な読み取り／書き込みアクセス

コントリビューション

GitHub へのプルリクエストを歓迎します。始めるには、次の手順に従ってください。

1. Git と Node.js をインストールします
2. リポジトリをクローンします
3. npm install で依存関係をインストールします
4. npm run test でテストを実行します
5. npm run build でビルドします

リリース

バージョンはセマンティックバージョニング仕様に従います。

リリースするには：

1. npm version <major | minor | patch> を使用してバージョンを更新します
2. git push --follow-tags を実行してタグとともにプッシュします
3. GitHub Actions が NPM レジストリに公開するまで待ちます。