Spreadsheet MCP Server

Google Spreadsheet 操作用の MCP (Model Context Protocol) サーバーです。 Cursor などの AI アシスタントから Google スプレッドシートを参照・操作できます。

機能

読み取り系ツール (Phase 1)

書き込み系ツール (Phase 2)

書式設定ツール (Phase 3)

セットアップ

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

cd spreadsheet-mcp
npm install

2. ビルド

npm run build

3. 認証情報の設定

このサーバーは以下の認証情報ファイルを使用します：

• Credential Store: ./config/credentials.json（自動作成）

初回実行時、ブラウザが開いて認証フローが始まります。個人の Google アカウントでログインして権限を許可してください。

4. Cursor への設定追加

Cursor の MCP 設定ファイル (~/.cursor/mcp.json または プロジェクトの .cursor/mcp.json) に以下を追加：

{
  "mcpServers": {
    "spreadsheet": {
      "command": "node",
      "args": ["~/spreadsheet-mcp/dist/index.js"]
    }
  }
}

使用例

シートの構造を確認

「このスプレッドシートの構造を見せて」
→ get_sheet_structure を使用

特定範囲のデータを取得

「Sheet1 の A1:D10 のデータを取得して」
→ get_sheet_data を使用

列の値パターンを確認

「D列の値のパターンを教えて」
→ get_column_values を使用

新規スプレッドシートを作成

「新しいスプレッドシートを作成して」
→ create_spreadsheet を使用

プロンプトテンプレート

設定シートを作成する際のプロンプトテンプレートを用意しています：

📄 prompts/create-config-sheet.md

• 既存シートを参考にして新機能用シートを作成

• ゼロから設定シートを作成

• 具体的な使用例

安全性

書き込み系ツールには dry_run オプションがあります。 dry_run: true を指定すると、実際の変更は行わずにプレビューのみを表示します。

開発

# ビルド
npm run build

# 実行
npm start

# 開発（ビルド + 実行）
npm run dev

ライセンス

MIT

spreadsheet-mcp