MCP Google Sheets MCP Server

`mcp-google-sheets` is a Python-based MCP server that acts as a bridge between any MCP-compatible client (like Claude Desktop) and the Google Sheets

Local serverstdioPython

What is the MCP Google Sheets MCP server?

Most developer tooling work still happens through a UI a human drives. MCP Google Sheets MCP server moves it into the conversation instead. mcp-google-sheets is a Python-based MCP server that acts as a bridge between any MCP-compatible client (like Claude Desktop) and the Google Sheets API. It allows you to interact with your Google Spreadsheets using a defined set of tools.

Getting it running

Installation goes through your MCP client rather than a global install: point it at mcp-google-sheets on PyPI and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

What it needs from you

Configuration is passed through the environment: SERVICE_ACCOUNT_PATH, ENABLED_TOOLS, DRIVE_FOLDER_ID, CREDENTIALS_CONFIG, YOUR_DRIVE_FOLDER_ID, THIS_IS_THE_FOLDER_ID, CREDENTIALS_PATH, TOKEN_PATH. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. It is maintained by xing5; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against MCP Google Sheets's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

How to install the MCP Google Sheets MCP server

{
     "mcpServers": {
       "google-sheets": {
         "command": "uvx",
         "args": [
           "mcp-google-sheets@latest",
           "--include-tools",
           "get_sheet_data,update_cells,list_spreadsheets,list_sheets"
         ],
         "env": {
           "SERVICE_ACCOUNT_PATH": "/path/to/credentials.json"
         }
       }
     }
   }

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
SERVICE_ACCOUNT_PATHFilesystem location the server is allowed to use.Optional
ENABLED_TOOLSConfiguration value read at startup.Optional
DRIVE_FOLDER_IDConfiguration value read at startup.Optional
CREDENTIALS_CONFIGConfiguration value read at startup.Optional
YOUR_DRIVE_FOLDER_IDConfiguration value read at startup.Optional
THIS_IS_THE_FOLDER_IDConfiguration value read at startup.Optional
CREDENTIALS_PATHFilesystem location the server is allowed to use.Optional
TOKEN_PATHCredential the server authenticates with.Yes

Frequently asked questions

It connects MCP Google Sheets to MCP-compatible AI assistants such as Claude and Cursor. Instead of copying data back and forth by hand, the assistant works with MCP Google Sheets directly.