Google Sheets Mcp

Google Sheets MCP

AI エージェントがスプレッドシートを直接操作できる、Google Sheets 用の Model Context Protocol（MCP）コネクターです。

デモ

https://github.com/user-attachments/assets/cc4729d9-4e6e-437b-848b-6da9a09418c3

セットアップ

1. このリポジトリをクローンします：

git clone https://github.com/mkummer225/google-sheets-mcp
cd google-sheets-mcp

2. 依存関係をインストールします： npm install

3. ビルドします： npm run build

4. Google Cloud Platform で OAuth 認証情報を作成します：

   • Google Cloud Console で新しいプロジェクトを作成します
   • Google Sheets API を有効にします
   • OAuth 同意画面を設定します
   • 適切なリダイレクト URI（例：http://localhost:3000/oauth2callback）を指定して、OAuth クライアント ID の認証情報（デスクトップアプリケーション）を作成します
   • 認証情報をダウンロードし、dist サブディレクトリに gcp-oauth.keys.json として保存します

5. MCP サーバーを起動します（必要に応じて Google アカウントの認証または再認証が自動的に求められます）： npm run start

使い方

設定例：

{
    "mcpServers": {
    "google-sheets-mcp": {
      "command": "node",
      "args": [
        "/{path_to_dir}/google-sheets-mcp/dist/index.js"
      ]
    }
  }
}

これで、スプレッドシート ID を指定するか、エージェントに新しいスプレッドシートを作成するよう依頼するだけで利用できます。

利用可能なアクション

アクション	説明
refresh_auth	認証情報の有効期限が切れたときに Google アカウントを再認証します
list_sheets	Google スプレッドシート内のすべてのシート／タブを一覧表示します
create_sheet	Google スプレッドシートに新しいシート／タブを作成します
create_spreadsheet	新しい Google スプレッドシートを作成します
read_all_from_sheet	指定したシートからすべてのデータを読み取ります
read_headings	シートの列見出しを読み取ります
read_rows	シートから指定した行を読み取ります
read_columns	シートから指定した列を読み取ります
edit_cell	シート内の単一セルを編集します
edit_row	シート内の行全体を編集します
edit_column	シート内の列全体を編集します
insert_row	指定した位置に新しい行を挿入します
insert_column	指定した位置に新しい列を挿入します
rename_sheet	スプレッドシート内のシート／タブの名前を変更します
rename_doc	Google スプレッドシートの名前を変更します

ライセンス

MIT