MCP Google Sheets Server

@shionhonda

Basic information

About MCP Google Sheets Server

Model Context Protocol (MCP) server that allows interaction with Google Sheets

MCP Google Sheets Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-gsheet": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

MCP Google Sheets Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Google Sheets Server?

MCP Google Sheets Server is a Model Context Protocol (MCP) server that enables interaction with Google Sheets. It is intended for AI agents or tools that need to list sheets, read cell ranges, and write data to spreadsheets, but it does not manage Google Drive files.

How to use MCP Google Sheets Server?

Set the GOOGLE_APPLICATION_CREDENTIALS environment variable to the absolute path of your service account JSON key, clone the repository, create a Python 3.11+ virtual environment with uv, install dependencies, then run mcp dev server.py (development) or mcp run server.py (production). The server communicates over standard input/output (stdio).

Key features of MCP Google Sheets Server?

List all sheet names (tabs) in a spreadsheet.
Read data from a specific cell range.
Write a 2D list of values to a specific cell range.
No Google Drive file management capabilities.
Authenticates via service account key.
Runs over stdio – suitable for MCP clients like Claude Desktop.

Use cases of MCP Google Sheets Server?

Extract data from Google Sheets for analysis or reporting.
Auto-populate spreadsheet cells from AI agent responses.
List sheets/tabs to discover spreadsheet structure.
Update cell values based on user queries or external inputs.

Frequently asked questions

What tools does MCP Google Sheets Server provide?

It provides three tools: `list_sheets(spreadsheet_id)`, `read_cells(spreadsheet_id, range_name)`, and `write_cells(spreadsheet_id, range_name, values)`.

Can I manage Google Drive files (create/delete folders) with this server?

No. The server explicitly does **not** provide tools for managing Google Drive files. Access is restricted to spreadsheet content only.

What are the runtime requirements?

Python 3.11+, a Google Cloud Project with the Google Sheets API enabled, and a downloaded service account key file (JSON). Dependencies are managed via `uv`.

How do I authenticate?

Set the environment variable `GOOGLE_APPLICATION_CREDENTIALS` to the absolute path of your service account JSON key file. The service account must have the "Editor" role on the target Google Sheets.

How do I run the server?

Use `mcp dev server.py` for development with MCP Inspector, or `mcp run server.py` for production. For Claude Desktop, add a JSON configuration block pointing to `uv` and the server path.

Comments

More Other MCP servers

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K