How do I install @sheetsmcp/server?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does @sheetsmcp/server need an API key?

No required environment variable is listed on this record.

What transport does @sheetsmcp/server use?

@sheetsmcp/server runs locally over stdio.

Servidor MCP @sheetsmcp/server

Q: When was @sheetsmcp/server last checked?

Last checked 2026-11-09. A local Google Sheets MCP server built for agent workflows in Claude Code and Claude Desktop: write API, script and file output into sheets, combine spreadsheets, refresh them on a schedule, across multiple Google accounts. Undo and formula-error checks o

Potencialize seu agente

Adicionar este servidor

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Rodar no PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @sheetsmcp/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add sheetsmcp-server -- npx -y @sheetsmcp/server@1.4.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "sheetsmcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "@sheetsmcp/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Rodar no PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Abrir

Server facts

Local

Transport: stdio
Version: 1.4.0
Last checked

Overview

About @sheetsmcp/server

A local Google Sheets MCP server built for agent workflows in Claude Code and Claude Desktop: write API, script and file output into sheets, combine spreadsheets, refresh them on a schedule, across multiple Google accounts. Undo and formula-error checks o

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Sheets MCP

The power tool for Google Sheets in Claude. A free, open-source MCP server that connects your spreadsheets to everything Claude Desktop and Claude Code can do: pull data from APIs and files into a sheet, build new sheets from your other sheets, keep them updated on a schedule, and work across several Google accounts. Formulas, formatting, charts and pivot tables included, with undo and formula-error checks on every write. It runs on your computer and talks to Google directly.

See all features and watch the demo at sheetsmcp.io →

Free and open source · Runs on your computer · Spreadsheet-only Google access · Claude Desktop and Claude Code

If Sheets MCP saves you time, a ⭐ on GitHub helps other people find it.

Sheets MCP or Claude's built-in Google Sheets integration?

Claude now has its own Google Sheets integration on paid plans. Both let Claude edit your spreadsheets; they suit different jobs.

	Sheets MCP	Claude's built-in integration
Best for	Work that reaches beyond one sheet: APIs, files, other sheets, schedules	Quick edits inside the sheet you have open
Price	Free, and works on the free Claude plan in Claude Desktop	Paid Claude plans
Where it works	Claude Desktop (Chat and Code tabs) and Claude Code	Claude chat, and a sidebar inside Google Sheets
Setup	One-click extension or one command. Google shows an "unverified app" screen at sign-in for now	Built in
Where your data goes	From your computer straight to Google, with access to spreadsheets only. No other servers	Through Anthropic's hosted connector
Code	Open source (MIT): read it, change it, run your own	Anthropic's product
Extras	Several Google accounts, undo, formula-error checks, live preview in the chat	Sidebar in Sheets, edit approvals, Python for data cleaning

In short: on a paid plan and only want Claude to edit the sheet in front of you? The built-in integration is the simplest. Want Claude to pull your sheets together with everything else, for free? Use Sheets MCP. You can use both.

Install

Claude Desktop (easiest, no setup)

Install Claude Desktop and sign in.
Download Sheets MCP for Claude Desktop (a .mcpb file; see what's new).
Double-click the file, then click Install in Claude Desktop.

New to Claude Desktop? Follow the step-by-step setup guide.

The extension works in both the Chat and Code tabs. For long, multi-step jobs, the Code tab is the more dependable choice: it runs everything on your computer.

Claude Code

Requires Node.js 18 or newer. Run:

claude mcp add --scope user google-sheets -- npx -y @sheetsmcp/server

Then start a new Claude Code session.

Sign in

The first time Claude uses Google Sheets, a Google sign-in page opens in your browser:

Choose your Google account.
Google shows "Google hasn't verified this app". Click Advanced, then Go to Sheets MCP.
Click Continue to allow access to your spreadsheets.

To use more than one Google account, ask Claude to "sign in to another Google account". When you paste a sheet link, Sheets MCP uses whichever of your accounts can open it.

To open the Google sign-in in a particular browser without changing your default, add "browser": "Google Chrome" (or another app name) to ~/.sheets-mcp/settings.json.

If your company's Google Workspace blocks the sign-in, your Workspace admin can allow Sheets MCP under Admin console → Security → API controls.

Try asking

In Claude Desktop, click + and choose Get started with Google Sheets for a quick tour. When more than one Google account is connected, Claude asks which account to use before creating a spreadsheet, or when a sheet can be opened by more than one of your accounts.

"Summarize this sheet: "
"Add a Profit column that subtracts Cost from Revenue, and format it as currency"
"Chart spending by month in this sheet: "
"Freeze the header row, bold it, and auto-fit the column widths"
"Summarize revenue by region and product in a pivot table"
"Change that chart to a line chart and move it next to the table"
"Create a new spreadsheet called Trip Planner"
"Open my budget sheet" (works for sheets you've used with Sheets MCP before)
"Pull last week's Stripe payouts into the Cash tab" (Claude Code)
"Combine the East and West sales sheets into a new Q3 summary with a chart"
"Copy the Q4 forecast from my work account into the board sheet on my personal account"
"Undo that"

More example requests and everything Sheets MCP can do →

Recently worked on

Sheets MCP keeps a list of the spreadsheets you've used with it, on your computer. In Claude Desktop, start talking about your sheets ("let's work on my budget") or ask "show my recent sheets", and a searchable list opens in the chat: pin the ones you use most, open them in Google Sheets, or tick several (even from different Google accounts) and send them to Claude with what you want done. In Claude Code, type /mcp__google-sheets__recent_sheets or ask "which sheets have I used?".

Live preview

In Claude Desktop, Claude opens a live preview of your sheet in the chat while it works. You see each range it reads and each change it makes as it happens, charts included, and the preview folds away when Claude is done. Open in Sheets jumps to the same cells in Google Sheets.

Ask Claude to explain a sheet ("walk me through how this model works") and the preview becomes a walkthrough: a progress bar while Claude reads, then Claude's explanation played on the sheet one point at a time. Claude's cursor outlines the cells for each point and types a short note beside them, and the walkthrough waits for you to click Next. Type a question about the point in the walkthrough and Claude answers there, stepping through the cells it's talking about. It's drawn in the preview only, so nothing changes in the sheet and collaborators see nothing.

After updating Sheets MCP, quit and reopen Claude Desktop so it loads the new preview.

The preview draws in the Claude desktop app. If you follow a session from your phone with Remote Control, Sheets MCP keeps working on your computer and the preview is there when you're back at it.

Watch it in action on sheetsmcp.io →

Privacy

Sheets MCP runs on your computer. Your Google sign-in is stored only on your computer (in ~/.sheets-mcp), and requests go straight from your computer to Google. There is no Sheets MCP server in between. It asks Google for access to your spreadsheets only, not the rest of your Drive. For finding sheets by name and the Recently worked on list, it keeps a list of the spreadsheets you've used with it in ~/.sheets-mcp/recent.json on your computer; delete that file to clear the list. Spreadsheet data Claude reads becomes part of your Claude conversation. See the privacy policy.

To disconnect, ask Claude to "sign out of Google Sheets", or remove Sheets MCP at myaccount.google.com/permissions.

Command line (optional)

npx @sheetsmcp/server auth                      # sign in to a Google account
npx @sheetsmcp/server accounts                  # list signed-in accounts
npx @sheetsmcp/server accounts default <email>  # choose the default account
npx @sheetsmcp/server accounts remove <email>   # sign out an account

Learn more

sheetsmcp.io: full feature list, demo, setup guide and FAQ
Privacy policy · Terms
Questions or bugs: open an issue

Adicionar este servidor

Host a copy with our keys and logs.

Server facts

About @sheetsmcp/server

Tools

Questions

How do I install @sheetsmcp/server?

Does @sheetsmcp/server need an API key?

What transport does @sheetsmcp/server use?

When was @sheetsmcp/server last checked?

Documentation

Sheets MCP

Sheets MCP or Claude's built-in Google Sheets integration?

Install

Claude Desktop (easiest, no setup)

Claude Code

Sign in

Try asking

Recently worked on

Live preview

Privacy

Command line (optional)

Learn more