About MCP Google Spreadsheet

What is MCP Google Spreadsheet: Automate Workflows & Seamless Sync?

MCP Google Spreadsheet is a specialized tool built using the Model Context Protocol (MCP) framework, enabling AI assistants to programmatically interact with Google Drive and Google Sheets. It acts as a server-side interface that grants controlled access to file management operations and spreadsheet data manipulation, streamlining automation tasks without manual intervention.

Key Features of MCP Google Spreadsheet: Automate Workflows & Seamless Sync?

Unified Drive Management: List, copy, and rename files across folders with granular permissions
Advanced Sheet Control: Full lifecycle management of spreadsheet sheets including data extraction, row/column manipulation, and bulk cell updates
Security-first Design: Enforces folder-level access restrictions and guards against path traversal attacks
Batch Processing: Execute multiple cell updates atomically for high-volume data operations

MCP Google Spreadsheet Features

How to Use MCP Google Spreadsheet: Automate Workflows & Seamless Sync?

Setup Environment: Install Go 1.24+ and configure Google Cloud APIs (Drive & Sheets) with OAuth credentials
Deploy Server: Run go install github.com/kazz187/mcp-google-spreadsheet@latest and set environment variables for API access
Integrate with AI: Configure MCP server details in your AI assistant's settings to enable programmatic spreadsheet access
Execute Actions: Use API commands like batch_update_cells or copy_file through your AI workflow orchestrator

Use Cases of MCP Google Spreadsheet: Automate Workflows & Seamless Sync?

Common applications include:

Automated report generation by pulling real-time data from multiple sheets
Batch file management for versioning and archiving projects
Dynamic dashboard updates via scheduled cell injections
Collaborative workflow automation using AI-driven data validation

MCP Google Spreadsheet FAQ

FAQ from MCP Google Spreadsheet: Automate Workflows & Seamless Sync?

Does this work with ChatGPT or Claude?: Yes, supports any MCP-compatible AI assistant with proper server configuration
What happens if credentials expire?: Automatic token refresh handles OAuth2 lifecycle management transparently
Can I restrict access to specific sheets?: Folder-level permissions are enforced, but sheet-level control requires manual spreadsheet configuration
How are errors handled?: Returns structured error responses with Google API-specific status codes for programmatic handling

Content

MCP Google Spreadsheet

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

機能

Google Drive 操作

list_files : Google Drive のファイル一覧を取得
copy_file : Google Drive のファイルをコピー
rename_file : Google Drive のファイル名を変更

Google Spreadsheet 操作

list_sheets : スプレッドシート内のシート一覧を取得
copy_sheet : スプレッドシート内のシートをコピー
rename_sheet : スプレッドシート内のシート名を変更
get_sheet_data : シートのデータを取得
add_rows : シートに行を追加
add_columns : シートに列を追加
update_cells : 単一範囲のセルを更新
batch_update_cells : 複数範囲のセルを一括更新

前提条件

Go 1.24 以上
Google Cloud Platform のプロジェクトと API 有効化
- Google Drive API
- Google Sheets API

インストール

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

Google API の設定手順

Google Cloud Console にアクセス
プロジェクトを作成
Google Drive API と Google Sheets API を有効化
認証情報を作成（OAuth クライアント ID）
クライアントシークレットをダウンロード

使用方法

起動

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 をブラウザで開いてください。

MCP 設定

Claude や ChatGPT などの AI アシスタントで使用するには、MCP の設定ファイルに以下のように追加します：

{
  "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"
      }
    }
  }
}

go install でインストールした場合は、command に絶対パスを指定する代わりに、上記のように実行ファイル名のみを指定することもできます。その場合は、MCP サーバーを実行するユーザーの PATH に $GOPATH/bin が含まれていることを確認してください。

セキュリティ

指定されたフォルダ ID 内のファイルのみにアクセスが制限されます
ディレクトリトラバーサル攻撃（../ などを使用したパス指定）は防止されます
ユーザーから指定されたファイルが指定フォルダ内に存在するかが検証されます

MCP Google Spreadsheet: Automate Workflows & Seamless Sync