# Google Sheets MCP Server

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

## 機能

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

## 前提
```
node -v
v24.8.0
```

## セットアップ

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

```bash
npm install
```

### 2. Google Cloud認証の設定

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

### 3. ビルド

```bash
npm run build
```

### 4. 起動

```bash
npm run start
```

## 使用方法

### Cursorでの使用

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

```json
{
  "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プロジェクトでサービスアカウントを作成し、キーファイルをダウンロードする必要があります