Google Sheets MCP Server
Googleスプレッドシートと連携するMCP(Model Context Protocol)サーバーです。 ローカル用です。
機能
- スプレッドシートの読み取り
- スプレッドシートへの書き込み
- 行の追加
- スプレッドシート情報の取得
- 新しいシートの作成
前提
node -v
v24.8.0
セットアップ
1. 依存関係のインストール
npm install
2. Google Cloud認証の設定
- Google Cloud Consoleでプロジェクトを作成
- Google Sheets APIを有効化
- サービスアカウントを作成し、JSONキーファイルをダウンロード
- ダウンロードしたキーファイルを
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プロジェクトでサービスアカウントを作成し、キーファイルをダウンロードする必要があります
