MCP Gsheet

🚀 MCP 谷歌表格サーバー

このプロジェクトは、モデルコンテキストプロトコル（MCP）サーバーを提供し、Google スプレッドシートとの相互作用を可能にします。 Google スプレッドシートの特定の操作を行うことができ、データの読み書きなどの機能を提供します。

✨ 主な機能

• スプレッドシート内のワークシート（タブ）を一覧表示します。
• 特定のセル範囲からデータを読み取ります。
• 特定のセル範囲にデータを書き込みます。

ただし、Google Drive ファイルの管理ツール（ファイル/フォルダの一覧表示、作成、削除）は提供していません。アクセスはスプレッドシートの内容に限定されます。

📦 インストール

前提条件

1. Python 3.11 以上
2. Google Sheets API を有効にした Google Cloud プロジェクト
3. サービスアカウントキー
   • Google Cloud Console にアクセスし、新しいサービスアカウントを作成します。
   • サービスアカウントキーファイル（JSON 形式）をダウンロードします。
   • このサービスアカウントに対象のスプレッドシートへの「編集者」ロールを付与します。

インストール手順

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

   git clone https://github.com/shionhonda/mcp-gsheet.git
   

2. Google の認証情報を設定します。
   • GOOGLE_APPLICATION_CREDENTIALS 環境変数を、ダウンロードしたサービスアカウントキーファイルの絶対パスに設定します。

   export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/service-account-key.json"
   

   • または、キーファイルを Google Cloud クライアントライブラリが認識する標準の場所に配置することもできます（共有環境では推奨されません）。
3. 依存関係をインストールします。

   uv venv
   source .venv/bin/activate
   

4. サーバーを起動します。 MCP チェッカー開発サーバーを使用する場合：

   mcp dev server.py
   

   サーバーを実行する場合：

   mcp run server.py
   

   サーバーが起動し、標準入力/出力（stdio）で MCP リクエストを待機します。

💻 使用例

Claude Desktop での設定

Claude Desktop の設定に以下の内容を追加します。

{
  "mcpServers": {
    "gsheet": {
      "command": "/path/to/uv",
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account-key.json"
      },
      "args": ["--directory", "/path/to/mcp-gsheet", "run", "server.py"]
    }
  }
}

MCP ツールの機能

• list_sheets(spreadsheet_id: str) -> list[str]：指定したスプレッドシート内のすべてのワークシート名を一覧表示します。
• read_cells(spreadsheet_id: str, range_name: str) -> list[list[str]]：指定した範囲（例: 'Sheet1!A1:B5'）からデータを読み取ります。
• write_cells(spreadsheet_id: str, range_name: str, values: list[list[str]]) -> str：指定した開始セル/範囲（例: 'Sheet1!C1'）に、提供された二次元文字列リストを書き込みます。