Skip to main content
Glama
Sign In
enesjakozh

mcp-google-sheets

by xing5
GitHub
Python
MIT License
  • Linux
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Integrates with Google Drive to list, access, and manage spreadsheets within shared folders, supporting both service account and OAuth authentication methods.

  • Enables creating, reading, updating, and managing Google Sheets spreadsheets, including operations like getting cell data, updating cells, creating spreadsheets, adding sheets, and manipulating rows and columns.

mcp-google-sheets: Google Sheets MCP サーバー

この MCP サーバーは Google ドライブおよび Google スプレッドシートと統合され、スプレッドシートの作成と変更が可能になります。

概要

Google Sheets と連携するためのモデルコンテキストプロトコルサーバー。このサーバーは、Google Sheets API を通じてスプレッドシートを作成、読み取り、更新、管理するためのツールを提供します。

ツール

  1. get_sheet_data
    • Google スプレッドシートの特定のシートからデータを取得する
    • 入力：
      • spreadsheet_id (文字列): スプレッドシートのID（URL内にあります）
      • sheet (文字列): シートの名前
      • range （オプションの文字列）：A1表記のセル範囲（例：'A1:C10'）
    • 戻り値: シートデータの2次元配列
  2. update_cells
    • Google スプレッドシートのセルを更新する
    • 入力：
      • spreadsheet_id (文字列): スプレッドシートのID
      • sheet (文字列): シートの名前
      • range (文字列): A1表記のセル範囲
      • data （2次元配列）：更新する値
    • 戻り値: 更新操作の結果
  3. batch_update_cells
    • Google スプレッドシートの複数の範囲を一括更新する
    • 入力：
      • spreadsheet_id (文字列): スプレッドシートのID
      • sheet (文字列): シートの名前
      • ranges (オブジェクト): 範囲文字列を値の2次元配列にマッピングする辞書
    • 戻り値: バッチ更新操作の結果
  4. list_sheets
    • Google スプレッドシートのすべてのシートを一覧表示する
    • 入力：
      • spreadsheet_id (文字列): スプレッドシートのID
    • 戻り値: シート名のリスト
  5. list_spreadsheets
    • 設定されたGoogleドライブフォルダ内のすべてのスプレッドシートを一覧表示します
    • 戻り値: IDとタイトルを含むスプレッドシートのリスト
    • 注: サービスアカウント認証を使用している場合は、共有フォルダ内のスプレッドシートが一覧表示されます。
  6. create_spreadsheet
    • 新しいGoogleスプレッドシートを作成する
    • 入力：
      • title (文字列): 新しいスプレッドシートのタイトル
    • 戻り値: 新しく作成されたスプレッドシートのIDを含む情報
    • 注: 設定されたフォルダIDでサービスアカウント認証を使用する場合、スプレッドシートはそのフォルダに作成されます。
  7. create_sheet
    • 既存の Google スプレッドシートに新しいシートタブを作成する
    • 入力：
      • spreadsheet_id (文字列): スプレッドシートのID
      • title (文字列): 新しいシートのタイトル
    • 戻り値: 新しく作成されたシートに関する情報
  8. 追加ツール: add_rows 、 add_columns 、 copy_sheet 、 rename_sheet

リソース

  1. spreadsheet://{spreadsheet_id}/info
    • Google スプレッドシートの基本情報を取得する
    • 戻り値: スプレッドシート情報を含むJSON文字列

インストールとセットアップ

サーバーを実行する前に、Google Cloud Platform でいくつかの設定を行い、認証方法を選択する必要があります。

Google Cloud Platform のセットアップ（すべての方法で必須）

  1. Google Cloud Platform プロジェクトを作成します。
    • Google Cloud Consoleに移動
    • 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
    • Google Sheets APIとGoogle Drive APIを有効にする

認証方法を選択する

次の 2 つの認証方法のいずれかを使用できます。

方法 1: サービス アカウント認証 (推奨、非対話型)

サービスアカウントは、ブラウザプロンプトなしでヘッドレス認証を提供するため、自動化環境やサーバー環境に最適です。次のようなメリットがあります。

  • 認証にブラウザの操作は不要
  • ヘッドレス環境でも問題なく動作します
  • 認証はOAuthトークンほど頻繁に期限切れにならない
  • サーバーの導入と自動化に最適

セットアップ手順:

  1. サービス アカウントを作成します。
    • Google Cloud Console → IAMと管理 → サービスアカウントに移動します
    • わかりやすい名前で新しいサービス アカウントを作成します
    • 適切なロールを付与する（Google スプレッドシートへのアクセス用）
    • JSONキーファイルを作成してダウンロードする
  2. Google ドライブにサービス アカウントと共有するための専用フォルダを作成します。
    • Google ドライブにアクセスし、新しいフォルダを作成します（例:「Claude Sheets」）
    • URL からフォルダの ID をメモします: https://drive.google.com/drive/folders/FOLDER_ID_HERE
    • フォルダを右クリックして「共有」を選択します
    • サービス アカウントのメール アドレス (JSON ファイルではclient_emailとして見つかります) と共有します。
    • 「編集者」権限を与える
  3. 次の環境変数を設定します。
    • SERVICE_ACCOUNT_PATH : サービスアカウントのJSONキーファイルへのパス
    • DRIVE_FOLDER_ID : サービス アカウントと共有されている Google ドライブ フォルダの ID

方法2: OAuth 2.0認証（インタラクティブ）

この方法では、初回セットアップ時にブラウザの操作が必要であり、個人使用や開発に適しています。

  1. プロジェクトの OAuth を設定します。
    • OAuth同意画面を設定する
    • OAuth 2.0 クライアント ID 認証情報を作成する (デスクトップ アプリケーション タイプ)
    • 資格情報JSONファイルをダウンロードし、 credentials.jsonとして保存します。
  2. 次の環境変数を設定します。
    • CREDENTIALS_PATH : ダウンロードしたOAuth認証情報ファイルへのパス（デフォルト: credentials.json ）
    • TOKEN_PATH : 認証トークンが保存されるパス（デフォルト: token.json ）

環境変数の設定

Linux/Macの場合:

# For service account authentication (recommended) export SERVICE_ACCOUNT_PATH=/path/to/your/service-account-key.json export DRIVE_FOLDER_ID=your_shared_folder_id_here # OR for OAuth authentication export CREDENTIALS_PATH=/path/to/your/credentials.json export TOKEN_PATH=/path/to/your/token.json

Windowsの場合:

# For service account authentication (recommended) set SERVICE_ACCOUNT_PATH=C:\path\to\your\service-account-key.json set DRIVE_FOLDER_ID=your_shared_folder_id_here # OR for OAuth authentication set CREDENTIALS_PATH=C:\path\to\your\credentials.json set TOKEN_PATH=C:\path\to\your\token.json

サーバーの実行

方法1：uvxを使用する（通常の使用に推奨）

uvxを使用する場合、インストールせずにサーバーを直接実行できます。

# Set environment variables first, then run the server uvx mcp-google-sheets

方法2：開発と変更の場合

サーバーを変更および開発する場合:

  1. リポジトリをクローンします。
git clone https://github.com/yourusername/mcp-google-sheets.git cd mcp-google-sheets
  1. uvで実行:
# Set environment variables first, then run uv run mcp-google-sheets

認証プロセス

サーバーは環境変数に基づいて認証方法を自動的に選択します。

  1. まず、サービス アカウントの資格情報を確認します (非対話型)
  2. サービスアカウントの認証が失敗した場合、または構成されていない場合は、OAuthフローにフォールバックします。

サービス アカウント認証を使用すると、ブラウザの操作は必要なくなり、サーバーは共有 Google ドライブ フォルダ内のスプレッドシートを直接操作します。

OAuth認証では、サーバーを初めて使用する際にブラウザウィンドウが開き、Googleアカウントで認証します。認証後、 TOKEN_PATH環境変数で指定された場所にトークンが保存されます。

Claude Desktopでの使用

これをclaude_desktop_config.jsonに追加します:

"mcpServers": { "google-sheets": { "command": "uvx", "args": ["mcp-google-sheets"], "env": { "SERVICE_ACCOUNT_PATH": "/path/to/your/service-account-key.json", "DRIVE_FOLDER_ID": "your_shared_folder_id_here" } } }
"mcpServers": { "google-sheets": { "command": "uvx", "args": ["mcp-google-sheets"], "env": { "CREDENTIALS_PATH": "/path/to/your/credentials.json", "TOKEN_PATH": "/path/to/your/token.json" } } }
"mcpServers": { "mcp-google-sheets": { "command": "uv", "args": [ "--directory", "/path/to/mcp-google-sheets", "run", "mcp-google-sheets" ], "env": { "SERVICE_ACCOUNT_PATH": "/path/to/mcp-google-sheets/service-account-key.json", "DRIVE_FOLDER_ID": "your_shared_folder_id_here" // OR for OAuth: // "CREDENTIALS_PATH": "/path/to/mcp-google-sheets/credentials.json", // "TOKEN_PATH": "/path/to/mcp-google-sheets/token.json" }, "disabled": false } }

クロードの例題

MCP サーバーが Claude に接続されると、次のようなプロンプトを使用できるようになります。

  • 「共有フォルダ内のすべてのスプレッドシートを一覧表示する」
  • 「『2024年度予算』というタイトルの新しいスプレッドシートを作成します」
  • 「ID 1A2B3C4D5E6F7G8H のスプレッドシートの Sheet1 からデータを取得します」
  • 「スプレッドシートの Sheet2 の先頭に 3 行追加する」
  • 「スプレッドシートのセルA1:B2を値[[1, 2], [3, 4]]で更新する」
  • 「予算スプレッドシートのすべてのシートを一覧表示する」
  • 「第 1 四半期のスプレッドシートから「3 月」シートを年間スプレッドシートにコピーし、名前を「第 1 四半期 - 3 月」に変更します。」
  • 「年間予算スプレッドシートに「Q4」という名前の新しいシートを追加する」

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。

クレジット

このプロジェクトは、kazz187/mcp-google-spreadsheetリポジトリからインスピレーションを得て、FastMCP を使用して Python に移植されました。

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

Google ドライブおよび Google スプレッドシートと統合され、ユーザーが自然言語コマンドを使用してスプレッドシートを作成、読み取り、更新、管理できるようにするモデル コンテキスト プロトコル サーバー。

  1. Overview
    1. Tools
    2. Resources
  2. Installation and Setup
    1. Google Cloud Platform Setup (Required for All Methods)
    2. Choose an Authentication Method
    3. Setting Environment Variables
  3. Running the Server
    1. Method 1: Using uvx (recommended for normal use)
    2. Method 2: For Development and Modifications
  4. Authentication Process
    1. Usage with Claude Desktop
  5. Example Prompts for Claude
    1. License
      1. Credits

        Appeared in Searches

        ID: nlrztecwtg