Googleスプレッドシート用のモデルコンテキストプロトコル(MCP)コネクタで、AIエージェントがスプレッドシートと直接やり取りできるようにします。

デモ

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

セットアップ

1. このリポジトリのクローン:

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

使用法

サンプル構成:

その後、スプレッドシートIDを指定するか、エージェントに新しいものを作成してもらうよう依頼すればよいはずです。

利用可能なアクション

Google Sheets MCP

A Model Context Protocol (MCP) connector for Google Sheets that allows AI agents to interact with spreadsheets directly.

Demo

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

Setup

1. Clone this repository:

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

2. Install dependencies: npm install

3. Build: npm run build

4. Create OAuth credentials in Google Cloud Platform:

   • Create a new project in Google Cloud Console
   • Enable the Google Sheets API
   • Configure the OAuth consent screen
   • Create OAuth client ID credentials (Desktop application) with an appropriate redirect URI (ex: http://localhost:3000/oauth2callback)
   • Download the credentials and save as gcp-oauth.keys.json in the dist subdirectory

5. Start the MCP server (you’ll automatically be prompted to authenticate/re-authenticate your Google account when necessary): npm run start

Usage

Sample config:

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

Then you should be able to simply specify your spreadsheetId or ask your agent to create a new one for you.

Available Actions

License

MIT