# Sheets MCP

Brings Google Sheets into Claude Code and desktop environments. Edits spreadsheet cells, draws charts, and catches formula errors locally.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 36
- Author: atc07
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/atc07/sheets-mcp
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/sheets-mcp

## What it does

The server runs on your machine and communicates directly with Google. Access is restricted strictly to spreadsheets. Claude can write values, format cells, generate pivot tables, and insert charts. Every modification triggers an automated formula-error check alongside full rollback support.

It works with multiple Google accounts simultaneously. You can pull values from personal sheets into corporate reports without juggling tokens. In Claude Desktop, a live view displays changes cell by cell, while Claude Code provides file history through `/mcp__google-sheets__recent_sheets`.

Running the tool requires Node.js 18 or later. The initial authorization triggers an unverified app alert in the browser, which requires proceeding past the advanced warning.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add sheets-mcp -- npx -y @sheetsmcp/server
```

### Codex

**Platform CLI**
```bash
codex mcp add sheets-mcp -- npx -y @sheetsmcp/server
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sheets-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@sheetsmcp/server"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "sheets-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@sheetsmcp/server"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add sheets-mcp npx -y @sheetsmcp/server
```

## When to use it
- build a pivot summary grouped by region
- format currency columns and auto-fit row headers
- transfer report tabs between two Google accounts
- revert unintended spreadsheet edits with undo

## Example prompts
- Calculate gross margin in column D and set currency formatting
- Turn the monthly expense breakdown into a line chart: <link>
- Revert the last batch of edits in the active sheet

## Similar
- [Excel MCP Server](https://affpapa.org/en/nevibecode/mcp/excel-mcp-server.md) — MCP server · ★ 4259
- [kordoc](https://affpapa.org/en/nevibecode/mcp/kordoc.md) — MCP server · ★ 2726
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/en/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP server · ★ 1247
- [Microsoft 365 MCP Server](https://affpapa.org/en/nevibecode/mcp/microsoft-365-mcp-server.md) — MCP server · ★ 1074
- [anymd](https://affpapa.org/en/nevibecode/mcp/anymd.md) — MCP server · ★ 1051
- [Docling MCP](https://affpapa.org/en/nevibecode/mcp/docling-mcp.md) — MCP server · ★ 777

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
