MCP Google Spreadsheet by kazz187 - MCP Server

MCP Google Spreadsheet

MCP (Model Context Protocol) サーバーとして実装された Google Spreadsheet および Google Drive 操作ツールです。このツールを使用することで、AI アシスタント（Claude Desktop など）が Google Spreadsheet や Google Drive のファイルを操作できるようになります。

機能

Google Drive 操作

google_drive_list_files: Google Drive 内のファイルとフォルダを一覧表示
google_drive_copy_file: ファイルまたはフォルダを別の場所にコピー
google_drive_rename_file: ファイルまたはフォルダの名前を変更

Google Spreadsheet 操作

google_sheets_list_sheets: スプレッドシート内のシート（タブ）一覧を取得
google_sheets_copy_sheet: シートを別のスプレッドシートにコピー
google_sheets_rename_sheet: シートの名前を変更
google_sheets_read_data: シートのデータを読み取り（スプレッドシートを「開く」操作）
google_sheets_add_rows: シートに空の行を挿入
google_sheets_add_columns: シートに空の列を挿入
google_sheets_update_cells: 指定範囲のセルの値を更新
google_sheets_batch_update_cells: 複数範囲のセルを一括更新
google_sheets_delete_rows: シートから行を削除
google_sheets_delete_columns: シートから列を削除

使用ワークフロー

google_drive_list_files で Google Drive 内のファイルを探索し、スプレッドシートを見つける
google_sheets_list_sheets で特定のスプレッドシート内のシート一覧を確認
google_sheets_read_data でシートの内容を表示
必要に応じて他の google_sheets_* ツールでデータを編集

前提条件

Go 1.24 以上
Google Cloud Platform のプロジェクトと API 有効化
- Google Drive API
- Google Sheets API
Google OAuth 2.0 認証の設定

インストール

go install github.com/kazz187/mcp-google-spreadsheet@latest

これにより、$GOPATH/bin ディレクトリに mcp-google-spreadsheet バイナリがインストールされます。

設定

以下の環境変数を設定する必要があります：

MCPGS_CLIENT_SECRET_PATH: Google API のクライアントシークレットファイルのパス (https://developers.google.com/identity/protocols/oauth2/native-app?hl=ja)
MCPGS_TOKEN_PATH: Google API のトークンファイルのパス（存在しない場合は自動的に作成されます）
MCPGS_FOLDER_ID: 操作対象とする Google Drive のフォルダ ID（フォルダを右クリック → リンクを取得 → URLの最後の部分）

Google API の設定手順

Google Cloud Console にアクセス
プロジェクトを作成
Google Drive API と Google Sheets API を有効化
認証情報を作成（OAuth クライアント ID）
- アプリケーションの種類：「デスクトップアプリケーション」を選択
クライアントシークレット JSON をダウンロード

使用方法

起動

export MCPGS_CLIENT_SECRET_PATH=/path/to/client_secret.json
export MCPGS_TOKEN_PATH=/path/to/token.json
export MCPGS_FOLDER_ID=your_folder_id
mcp-google-spreadsheet

go install でインストールした場合は、$GOPATH/bin が PATH に含まれていることを確認してください。

初回起動時は認証が必要です。ブラウザが自動的に開き、Google アカウントでの認証画面が表示されます。認証が完了すると自動的にアプリケーションに戻ります。ブラウザが自動的に開かない場合は、コンソールに表示される URL をブラウザで開いてください。

Claude Desktop での設定

Claude Desktop で使用する場合は、設定ファイル（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json）に以下のように追加します：

{
  "mcpServers": {
    "mcp_google_spreadsheet": {
      "command": "mcp-google-spreadsheet",
      "args": [],
      "env": {
        "MCPGS_CLIENT_SECRET_PATH": "/path/to/client_secret.json",
        "MCPGS_TOKEN_PATH": "/path/to/token.json",
        "MCPGS_FOLDER_ID": "your_folder_id"
      }
    }
  }
}