MCP Gsheets MCP Server

Model Context Protocol (MCP) server for Google Sheets API integration

Local serverstdioTypeScript

What is the MCP Gsheets MCP Server?

MCP Gsheets becomes available to MCP clients through the MCP Gsheets. Model Context Protocol (MCP) server for Google Sheets API integration.

What MCP Gsheets does

A Model Context Protocol (MCP) server for Google Sheets API integration. Enables reading, writing, and managing Google Sheets documents directly from your MCP client (e.g., Claude Code, Claude Desktop, Cursor, etc.).

Key capabilities

  • Complete Google Sheets Integration — Read, write, and manage spreadsheets
  • Advanced Operations — Batch operations, formatting, charts, and conditional formatting
  • Flexible Authentication — Support for both file-based and JSON string credentials
  • Production Ready — Built with TypeScript, comprehensive error handling, and full test coverage

Requirements

Practical notes

  • Maintained by freema, written in TypeScript.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
core11
sheets9
formatting15
charts3
tables4
analysis2
sheets_get_merged_cellsReturn all merged cell ranges for a sheet, with A1 notation and raw GridRange coordinates
sheets_get_sheet_dimensionsReturn column widths, row heights, frozen column/row counts, and hidden flags for every column and row
sheets_get_sheet_formattingRead raw cell formatting (background colour, font, borders, alignment, number format) for a range without returning cell values
sheets_get_conditional_formattingRead all conditional formatting rules and banded (alternating-colour) ranges defined on a sheet
sheets_get_sheet_structureLightweight structural metadata only — no per-cell data. Returns dimensions, frozen rows/cols, tab colour, column widths, row heights, hidden columns/rows, and all merges in A1 notation. Single fast API call
sheets_get_formatting_compactRead cell formatting for a range and return it as compact A1Range→format pairs (run-length encoded). Identical adjacent cells are collapsed into rectangular ranges — reduces output by 90 %+ compared to per-cell data

How to install the MCP Gsheets MCP Server

{
  "mcpServers": {
    "mcp-gsheets": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-gsheets@latest"
      ],
      "env": {
        "GOOGLE_PROJECT_ID": "your-project-id",
        "GOOGLE_APPLICATION_CREDENTIALS": "YOUR_GOOGLE_APPLICATION_CREDENTIALS"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
GOOGLE_PROJECT_IDDeclared in the maintainer’s client configuration.Optional
GOOGLE_APPLICATION_CREDENTIALSDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use MCP Gsheets to Toolset.”
  • “Use MCP Gsheets to core.”
  • “Use MCP Gsheets to sheets.”

Frequently asked questions

Model Context Protocol (MCP) server for Google Sheets API integration Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.