Google Sheets MCP Server

Name: Google Sheets MCP Server
Author: amaboh

@amaboh

リポジトリ

Google Sheets MCP Server について

A Model Context Protocol (MCP) server implementation for Google Sheets

基本情報

カテゴリ

その他

ライセンス

MIT license

ランタイム

python

トランスポート

stdio

公開者

amaboh

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "google-sheets-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Google Sheets MCP Server?

A Model Context Protocol (MCP) server that enables Claude Desktop to interact with Google Sheets directly. It provides tools for creating, reading, writing, and managing Google Sheets through Claude Desktop.

How to use Google Sheets MCP Server?

Install Python 3.10+, set up a virtual environment, install dependencies with uv, and configure Google Cloud OAuth 2.0 credentials. Then add the server to Claude Desktop’s claude_desktop_config.json with the path to the Python interpreter and the credentials file. Run the server manually once to complete browser-based OAuth authentication; the token is saved automatically. After setup, use commands like create_sheet, format_range, or write_formula directly in Claude Desktop.

Key features of Google Sheets MCP Server

Create new Google Sheets
Read and write data to existing sheets
Format cells and ranges
Add and delete sheets
Write formulas
Search for sheets
List available sheets

Use cases of Google Sheets MCP Server

Automate spreadsheet creation and data entry via conversation
Format ranges and apply formulas without leaving Claude Desktop
Manage multiple sheets (add/delete) through natural language
Quickly look up or list existing Google Sheets

FAQ from Google Sheets MCP Server

What are the prerequisites?

Python 3.10 or higher, a Google Cloud Project with the Sheets API and Drive API enabled, OAuth 2.0 credentials, and the uv package manager. Claude Desktop is also required.

How do I set up OAuth authentication?

Download OAuth 2.0 credentials from the Google Cloud Console as a JSON file and save it to ~/.config/google_sheets_mcp/google-sheets-mcp.json. The first server run will open a browser to authorize the application; the resulting token is saved automatically.

What tools/commands are available?

Tools include create_sheet, format_range, write_formula, add_sheet, delete_sheet, and get_sheet_properties.

How do I troubleshoot authentication issues?

Ensure the OAuth credentials file is valid, that your email is added as a test user in the Google Cloud project, and try deleting token.json and re‑authenticating.

What if the server won’t connect?

Check that the server is running, verify the credentials path in the Claude Desktop configuration, and review logs in Claude Desktop for error messages.