MCP Google Sheets Server

MCP Google Sheets サーバー

このプロジェクトでは、Google Sheets を操作するための Model Context Protocol（MCP）サーバーを提供します。

次のツールを公開します。

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

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

前提条件

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

使用方法

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

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

2. Google の認証情報を設定します：

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

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

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

3. 依存関係をインストールします：

   uv venv
   source .venv/bin/activate
   

4. サーバーを実行します

   MCP Inspector を使ってサーバーを開発するには：

   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'）に、指定した 2 次元の値リストを書き込みます。