Google Sheets MCP Server

Googleスプレッドシートと連携するMCP（Model Context Protocol）サーバーです。 ローカル用です。

機能

• スプレッドシートの読み取り
• スプレッドシートへの書き込み
• 行の追加
• スプレッドシート情報の取得
• 新しいシートの作成

前提

node -v
v24.8.0

セットアップ

1. 依存関係のインストール

npm install

2. Google Cloud認証の設定

1. Google Cloud Consoleでプロジェクトを作成
2. Google Sheets APIを有効化
3. サービスアカウントを作成し、JSONキーファイルをダウンロード
4. ダウンロードしたキーファイルをkey/ディレクトリに配置（mkdir key）

3. ビルド

npm run build

4. 起動

npm run start

使用方法

Cursorでの使用

mcp.jsonを設定してCursorで使用できます：

{
  "mcp": {
    "servers": {
      "google-sheets": {
        "command": "node",
        "args": ["プロジェクトまでの絶対パス/dist/index.js"],
        "env": {
          "GOOGLE_APPLICATION_CREDENTIALS": "プロジェクトまでの絶対パス/key/your-service-account-key.json"
        }
      }
    }
  }
}

重要: GOOGLE_APPLICATION_CREDENTIALSのパスは、ダウンロードしたサービスアカウントキーファイルの実際のパスに変更してください。 重要: スプレットシートの右上にある「共有」からサービスアカウントのメールアドレスを追加

利用可能なツール

• read_sheet: スプレッドシートの指定された範囲のデータを読み取る
• write_sheet: スプレッドシートの指定された範囲にデータを書き込む
• append_row: スプレッドシートの最後に新しい行を追加する
• get_sheet_info: スプレッドシートの基本情報を取得する
• create_sheet: 新しいシートを作成する

注意事項

• サービスアカウントのキーファイルは機密情報です。.gitignoreに追加して、リポジトリにコミットしないでください
• スプレッドシートにアクセスするには、サービスアカウントのメールアドレスをスプレッドシートの共有設定に追加する必要があります
• 各利用者は自分のGoogle Cloudプロジェクトでサービスアカウントを作成し、キーファイルをダウンロードする必要があります