Google Sheets API統合のためのモデルコンテキストプロトコル(MCP)サーバー。MCPクライアント(例:Claude Code、Claude Desktop、Cursorなど)から直接Google Sheetsのドキュメントの読み書き、管理を可能にします。

主な特徴

• Googleスプレッドシート統合を完全に:スプレッドシートの読み書き・管理
• 高度な操作:バッチ操作、書式設定、チャート、条件付き書式
• 柔軟な認証:ファイルベースおよびJSON文字列認証の両方のサポート
• 本番対応:TypeScript、包括的なエラー処理、完全なテストカバレッジで構築

要件

• Node.js v20以上
• Sheets APIが有効なGoogle Cloud Project(Google Cloud Project)
• JSONキーファイルを持つサービスアカウント
• NPM

始めて

クイックインストール(推奨)

以下の設定をMCPクライアントに追加してください:

[!注] mcp-gsheets@latestを使うことで、MCPクライアントは常に最新のバージョンのGoogleスプレッドシートサーバーを使用します。

MCPクライアント設定

クロード符号 Claude CodeのCLIを使ってMCPのGoogleスプレッドシートサーバーを追加してください(ガイド):

追加後、Claude Codeの設定を編集して必要な環境変数を追加してください:

Claude Desktop

MCP Google Sheets Server

A Model Context Protocol (MCP) server for Google Sheets API integration. Enables reading, writing, and managing Google Sheets documents directly from your MCP client (e.g., Claude Code, Claude Desktop, Cursor, etc.).

Key Features

• Complete Google Sheets Integration: Read, write, and manage spreadsheets
• Advanced Operations: Batch operations, formatting, charts, and conditional formatting
• Flexible Authentication: Support for both file-based and JSON string credentials
• Production Ready: Built with TypeScript, comprehensive error handling, and full test coverage

Requirements

• Node.js v22 or higher
• Google Cloud Project with Sheets API enabled
• Service Account with JSON key file
• npm

Getting Started

Quick Install (Recommended)

Add the following config to your MCP client:

{
  "mcpServers": {
    "mcp-gsheets": {
      "command": "npx",
      "args": ["-y", "mcp-gsheets@latest"],
      "env": {
        "GOOGLE_PROJECT_ID": "your-project-id",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account-key.json"
      }
    }
  }
}

[!NOTE] Using mcp-gsheets@latest ensures that your MCP client will always use the latest version of the MCP Google Sheets server.

MCP Client Configuration

Add to your Claude Desktop config: