google-sheets-mcp

Google Sheets MCP Server

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

mcp-name: io.github.henilcalagiya/google-sheets-mcp

概要

Google Sheets MCP Server は、Google Sheets と MCP 互換クライアントをシームレスに統合します。シンプルで安全な API レイヤーを通じて、シートの作成、読み取り、更新、削除など、スプレッドシートの完全な自動化を実現します。

機能

• Google Sheets とテーブルの完全な CRUD に対応
• Continue.dev、Claude Desktop、Perplexity、その他の MCP クライアントで動作
• Google サービスアカウントによる安全な認証
• Google Sheets の自動化に対応する包括的なツール
• uvx による自動インストール

要件

• Python 3.10+
• uv パッケージマネージャー（uvx コマンド用）
• サービスアカウントを含む 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 サービスアカウントを設定する

手順 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：サービスアカウントを作成する

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_id（例：「a4ae73111b11b2c3b07cc01006e71eb8230dfa29」）
• private_key（「-----BEGIN PRIVATE KEY-----」で始まる長い秘密鍵）
• client_email（例：「sheets-mcp-service@my-sheets-automation-123456.iam.gserviceaccount.com」）
• client_id（例：「113227823918217958816」）
• client_x509_cert_url（例：「https://www.googleapis.com/robot/v1/metadata/x509/sheets-mcp-service%40my-sheets-automation-123456.iam.gserviceaccount.com」）

Google サービスアカウント JSON の構造例：

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "your-private-key-id",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
  "client_email": "[email protected]",
  "client_id": "your-client-id",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/your-service%40your-project.iam.gserviceaccount.com"
}

必要に応じてこちらのガイドを参照してください

2. MCP クライアントを設定する

{
  "mcpServers": {
    "google-sheets-mcp": {
      "command": "uvx",
      "args": ["google-sheets-mcp@latest"],
      "env": {
        "project_id": "your-project-id",
        "private_key_id": "your-private-key-id",
        "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
        "client_email": "[email protected]",
        "client_id": "your-client-id",
        "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/your-service%40your-project.iam.gserviceaccount.com"
      }
    }
  }
}

💡 ヒント： Google サービスアカウントの JSON ファイルから値を直接コピーできます。JSON ファイル内のフィールド名がそのまま使われるため、変更は不要です！

🔄 下位互換性： 既存の設定向けに、サーバーは GOOGLE_PROJECT_ID など、以前の GOOGLE_ 接頭辞付き変数名にも対応しています。

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

• ウェブブラウザーで対象の Google スプレッドシートを開きます。
• 共有ボタンをクリックします。
• サービスアカウントのメールアドレス（例：[email protected]）を入力し、編集者アクセス権を付与します。
• 送信をクリックして、編集権限を付与します。

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

ライセンス

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

作者

Henil C Alagiya

• GitHub: @henilcalagiya
• LinkedIn: Henil C Alagiya

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

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