Enables interaction with Google Spreadsheets, allowing users to create, read, and manipulate sheet data, metadata, and formatting, as well as manage sheet structure and data validation.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Spreadsheet MCP ServerRead the first 10 rows of the 'Sales' sheet and summarize the data."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Spreadsheet MCP Server
Google Spreadsheet 操作用の MCP (Model Context Protocol) サーバーです。 Cursor などの AI アシスタントから Google スプレッドシートを参照・操作できます。
機能
読み取り系ツール (Phase 1)
ツール | 説明 |
| シート一覧、列名、行数を取得 |
| 指定範囲のセルデータを取得 |
| 特定列の全値を取得 |
| ヘッダー、データ型推定、サンプルデータを取得 |
| 特定文字列を検索 |
| セルエラー（#REF!, #VALUE! 等）を検出 |
書き込み系ツール (Phase 2)
ツール | 説明 |
| 新規スプレッドシートを作成 |
| 既存スプレッドシートにシートを追加 |
| ヘッダー行を設定 |
| データ行を追加 |
書式設定ツール (Phase 3)
ツール | 説明 |
| ヘッダースタイル、列幅、交互行カラーを設定 |
| ドロップダウン、数値範囲などの入力規則を設定 |
セットアップ
1. 依存関係のインストール
2. ビルド
3. 認証情報の設定
このサーバーは以下の認証情報ファイルを使用します：
Credential Store:
./config/credentials.json（自動作成）
初回実行時、ブラウザが開いて認証フローが始まります。個人の Google アカウントでログインして権限を許可してください。
4. Cursor への設定追加
Cursor の MCP 設定ファイル (~/.cursor/mcp.json または プロジェクトの .cursor/mcp.json) に以下を追加：
使用例
シートの構造を確認
特定範囲のデータを取得
列の値パターンを確認
新規スプレッドシートを作成
プロンプトテンプレート
設定シートを作成する際のプロンプトテンプレートを用意しています：
📄 prompts/create-config-sheet.md
既存シートを参考にして新機能用シートを作成
ゼロから設定シートを作成
具体的な使用例
安全性
書き込み系ツールには dry_run オプションがあります。
dry_run: true を指定すると、実際の変更は行わずにプレビューのみを表示します。
開発
ライセンス
MIT