Spreadsheet MCP Server
Google Spreadsheet 操作用の MCP (Model Context Protocol) サーバーです。 Cursor などの AI アシスタントから Google スプレッドシートを参照・操作できます。
機能
読み取り系ツール (Phase 1)
| ツール | 説明 |
|---|---|
get_sheet_metadata | シート一覧、列名、行数を取得 |
get_sheet_data | 指定範囲のセルデータを取得 |
get_column_values | 特定列の全値を取得 |
get_sheet_structure | ヘッダー、データ型推定、サンプルデータを取得 |
search_in_sheet | 特定文字列を検索 |
check_sheet_errors | セルエラー（#REF!, #VALUE! 等）を検出 |
書き込み系ツール (Phase 2)
| ツール | 説明 |
|---|---|
create_spreadsheet | 新規スプレッドシートを作成 |
create_sheet | 既存スプレッドシートにシートを追加 |
set_headers | ヘッダー行を設定 |
append_rows | データ行を追加 |
書式設定ツール (Phase 3)
| ツール | 説明 |
|---|---|
format_sheet | ヘッダースタイル、列幅、交互行カラーを設定 |
set_data_validation | ドロップダウン、数値範囲などの入力規則を設定 |
セットアップ
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