Google Sheet MCP Server

🚀 Google Sheets MCP サーバー

このサーバーは、強力なモデルコンテキストプロトコル (MCP) をベースに構築され、Google Sheets API とのシームレスな統合を実現します。AI アシスタントが Google スプレッドシートの作成、読み取り、更新、管理を行えるようになります。

✨ 主な機能

• Google スプレッドシートの作成、読み取り、更新、削除
• セルレベルの操作でスプレッドシートデータを管理
• セルと範囲の書式設定
• 他のユーザーとスプレッドシートを共有
• スプレッドシートを検索
• 充実した認証オプション

🔐 認証オプション

この MCP サーバーは、複数の認証方法をサポートしています。

1. サービスアカウント認証（本番環境での推奨）

   • サービスアカウントのキーファイルへのパスを指定する
   • または、サービスアカウントの JSON 内容を直接指定する

2. API Key 認証（開発時の簡易な方法）

   • Google API キーを指定する

3. OAuth2 認証（特定のユーザー操作に使用）

   • OAuth クライアント ID、クライアントシークレット、リフレッシュトークンを指定する

📦 インストール

前提条件

• Node.js (v16 以上)
• Google Sheets API が有効になっている Google Cloud プロジェクト
• Google Cloud の認証資格情報（下記参照）

手順

1. リポジトリをクローンします。

git clone https://github.com/yourusername/google-sheets-mcp-server.git
cd google-sheets-mcp-server

2. 依存関係をインストールします。

npm install

3. 認証を設定します。

• .env.example テンプレートを元に .env ファイルを作成します。
• Google Cloud の認証資格情報を追加します。

4. プロジェクトをビルドします。

npm run build

5. サーバーを起動します。

npm start

OAuth 設定

ユーザーの同意が必要な操作（スプレッドシートの作成/編集など）には、OAuth 資格情報が必要です。

1. Google Cloud コンソールで OAuth 資格情報を作成します。
2. src/get-refresh-token.js の CLIENT_ID と CLIENT_SECRET を更新します。
3. 必要な依存関係をインストールします。

npm install open server-destroy

4. リフレッシュトークンを取得するためのスクリプトを実行します。

node src/get-refresh-token.js

5. ブラウザの指示に従って承認を行います。
6. リフレッシュトークンを .env ファイルにコピーします。

💻 使用例

基本的な使用法

この MCP サーバーを Claude と一緒に使用する例を示します。

これで Google スプレッドシートを使用できます！以下のコマンドを試してみてください。

1. 新しいスプレッドシートを作成する：
   "タイトルが '月間予算' の新しい Google スプレッドシートを作成して"

2. スプレッドシートにデータを追加する：
   "私の月間予算スプレッドシートに支出のカテゴリと金額を追加して"

3. スプレッドシートの書式を設定する：
   "見出し行を太字にして中央揃えにして"

4. スプレッドシートを共有する：
   "私の月間予算スプレッドシートを john@example.com と共有して"

📚 ドキュメント

サーバーは以下のツールを提供しています。

• google_sheets_create：新しい Google スプレッドシートを作成する
• google_sheets_get：ID で Google スプレッドシートを取得する
• google_sheets_update_values：Google スプレッドシートの値を更新する
• google_sheets_append_values：Google スプレッドシートに値を追加する
• google_sheets_get_values：Google スプレッドシートから値を取得する
• google_sheets_clear_values：Google スプレッドシートの値をクリアする
• google_sheets_add_sheet：既存のスプレッドシートに新しいワークシートを追加する
• google_sheets_delete_sheet：スプレッドシートからワークシートを削除する
• google_sheets_list：認証されたユーザーが利用可能な Google スプレッドシートを一覧表示する
• google_sheets_delete：Google スプレッドシートを削除する
• google_sheets_share：特定のユーザーと Google スプレッドシートを共有する
• google_sheets_search：タイトルで Google スプレッドシートを検索する
• google_sheets_format_cells：Google スプレッドシートのセルの書式を設定する
• google_sheets_verify_connection：Google スプレッドシート API との接続を検証する

📄 ライセンス

MIT