Google Sheets MCP

🚀 Google Sheets MCP Server

Model Context Protocol (MCP)を使用してGoogle Sheetsを自動化する強力なツール

🚀 クイックスタート

Google Sheets MCP Serverは、Google Sheetsを任意のMCP互換クライアントとシームレスに統合します。簡単かつ安全なAPI層を介して、スプレッドシートの作成、読み取り、更新、削除を含む完全な自動化を可能にします。

✨ 主な機能

• Google Sheetsとテーブルの完全なCRUDサポート
• Continue.dev、Claude Desktop、PerplexityなどのMCPクライアントと互換
• Google Service Accountを介した安全な認証
• Google Sheets自動化のための包括的なツール
• uvxを介した自動インストール

📦 インストール

必要条件

• Python 3.10以上
• uvパッケージマネージャー (uvxコマンド用)
• Service Accountを持つGoogle Cloudプロジェクト
• MCP互換クライアント (例: Continue.dev)

uvのインストール:

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows PowerShell
irm https://astral.sh/uv/install.ps1 | iex

1. Google Service Accountの設定

ステップ1: Google Cloudプロジェクトの作成

1. Google Cloud Consoleにアクセスします。
2. 「プロジェクトを選択」→「新しいプロジェクト」をクリックします。
3. プロジェクト名 (例: "my-sheets-automation") を入力します。
4. 「作成」をクリックします。

ステップ2: 必要なAPIの有効化

1. プロジェクト内で、「APIとサービス」→「ライブラリ」に移動します。
2. 「Google Sheets API」を検索し、クリックして「有効化」します。
3. 「Google Drive API」を検索し、クリックして「有効化」します。

ステップ3: Service Accountの作成

1. 「IAMと管理」→「サービスアカウント」に移動します。
2. 「サービスアカウントを作成」をクリックします。
3. サービスアカウント名 (例: "sheets-mcp-service") を入力します。
4. 「作成して続行」をクリックします。
5. ロールの割り当てをスキップし、「続行」をクリックします。
6. 「完了」をクリックします。

ステップ4: JSONキーの生成

1. 新しいサービスアカウントのメールアドレスをクリックします。
2. 「キー」タブ → 「キーを追加」→「新しいキーを作成」をクリックします。
3. 「JSON」形式を選択し、「作成」をクリックします。
4. JSONファイルが自動的にダウンロードされます。

ステップ5: 必要な値の抽出 ダウンロードしたJSONファイルを開き、以下の値をメモします。

• project_id (例: "my-sheets-automation-123456")
• private_key ("-----BEGIN PRIVATE KEY-----"で始まる長い秘密鍵)
• client_email (例: "sheets-mcp-service@my-sheets-automation-123456.iam.gserviceaccount.com")

必要に応じてこのガイドに従ってください

2. MCPクライアントの設定

{
  "mcpServers": {
    "google-sheets-mcp": {
      "command": "uvx",
      "args": ["google-sheets-mcp@latest"],
      "env": {
        "GOOGLE_PROJECT_ID": "your-project-id",
        "GOOGLE_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
        "GOOGLE_CLIENT_EMAIL": "your-service@your-project.iam.gserviceaccount.com"
      }
    }
  }
}

これらの値は、GoogleサービスアカウントのJSONファイルから抽出します。

• project_id → GOOGLE_PROJECT_ID
• private_key → GOOGLE_PRIVATE_KEY
• client_email → GOOGLE_CLIENT_EMAIL

3. Googleシートをサービスアカウントと共有する

• ウェブブラウザで対象のGoogleスプレッドシートを開きます。
• 「共有」ボタンをクリックします。
• 「サービスアカウントのメールアドレス」 (例: your-service@your-project.iam.gserviceaccount.com) を入力し、「編集者」アクセスを割り当てます。
• 「送信」をクリックして編集者権限を付与します。

🎉 設定完了です！ MCPクライアントは必要に応じてパッケージを自動的にインストールして実行します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細についてはLICENSEファイルを参照してください。

作者

Henil C Alagiya

• GitHub: @henilcalagiya
• LinkedIn: Henil C Alagiya

サポートとコントリビューション:

• 🐛 問題の報告: GitHub Issues
• 💬 質問: LinkedInで問い合わせてください。
• 🤝 コントリビューション: プルリクエストを歓迎します！