kazz187/mcp-google-spreadsheet

MCP (Model Context Protocol) サーバーとして実装された Google Spreadsheet および Google Drive 操作ツールです。このツールを使用することで、AI アシスタント（Claude Desktop など）が Google Spreadsheet や Google Drive のファイルを操作できるようになります。
## 機能
### Google Drive 操作
googledrivelistfiles: Google Drive 内のファイルとフォルダを一覧表示
googledrivecopyfile: ファイルまたはフォルダを別の場所にコピー
googledriverenamefile: ファイルまたはフォルダの名前を変更
### Google Spreadsheet 操作
googlesheetslistsheets: スプレッドシート内のシート（タブ）一覧を取得
googlesheetscopysheet: シートを別のスプレッドシートにコピー
googlesheetsrenamesheet: シートの名前を変更
googlesheetsreaddata: シートのデータを読み取り（スプレッドシートを「開く」操作）
googlesheetsaddrows: シートに空の行を挿入
googlesheetsaddcolumns: シートに空の列を挿入
googlesheetsupdatecells: 指定範囲のセルの値を更新
googlesheetsbatchupdatecells: 複数範囲のセルを一括更新
googlesheetsdeleterows: シートから行を削除
googlesheetsdeletecolumns: シートから列を削除
## 使用ワークフロー
1. googledrivelistfiles で Google Drive 内のファイルを探索し、スプレッドシートを見つける
2. googlesheetslistsheets で特定のスプレッドシート内のシート一覧を確認
3. googlesheetsreaddata でシートの内容を表示
4. 必要に応じて他の googlesheets ツールでデータを編集
## 前提条件
Go 1.24 以上
Google Cloud Platform のプロジェクトと API 有効化
Google Drive API
Google Sheets API
Google OAuth 2.0 認証の設定
## インストール
bash
go install github.com/kazz187/mcp-google-spreadsheet@latest
これにより、$GOPATH/bin ディレクトリに mcp-google-spreadsheet バイナリがインストールされます。
## 設定
以下の環境変数を設定する必要があります：
MCPGSCLIENTSECRETPATH: Google API のクライアントシークレットファイルのパス (https://developers.google.com/identity/protocols/oauth2/native-app?hl=ja)
MCPGSTOKENPATH: Google API のトークンファイルのパス（存在しない場合は自動的に作成されます）
MCPGSFOLDERID: 操作対象とする Google Drive のフォルダ ID（フォルダを右クリック → リンクを取得 → URLの最後の部分）
### Google API の設定手順
1. Google Cloud Console にアクセス
2. プロジェクトを作成
3. Google Drive API と Google Sheets API を有効化
4. 認証情報を作成（OAuth クライアント ID）
アプリケーションの種類：「デスクトップアプリケーション」を選択
5. クライアントシークレット JSON をダウンロード
## 使用方法
### 起動
bash
export MCPGSCLIENTSECRETPATH=/path/to/clientsecret.json
export MCPGSTOKENPATH=/path/to/token.json
export MCPGSFOLDERID=yourfolderid
mcp-google-spreadsheet
go install でインストールした場合は、$GOPATH/bin が PATH に含まれていることを確認してください。
初回起動時は認証が必要です。ブラウザが自動的に開き、Google アカウントでの認証画面が表示されます。認証が完了すると自動的にアプリケーションに戻ります。ブラウザが自動的に開かない場合は、コンソールに表示される URL をブラウザで開いてください。
### Claude Desktop での設定
Claude Desktop で使用する場合は、設定ファイル（macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json）に以下のように追加します：
json
"mcpServers": {