Spreadsheet MCP Server

@HosakaKeigo

Repository

Basic information

About Spreadsheet MCP Server

No overview available yet

#spreadsheet #mcp #server

Spreadsheet MCP Server config

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

{
  "mcpServers": {
    "spreadsheet-mcp-server": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "node",
        "build/index.js"
      ]
    }
  }
}

Spreadsheet MCP 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.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Spreadsheet MCP Server?

It is a Model Context Protocol (MCP) server that provides access to Google Spreadsheet data, enabling LLMs to directly use spreadsheet information.

How to use Spreadsheet MCP Server?

Clone the repository, install dependencies with npm install, configure environment variables (GAS_WEB_APP_URL and GAS_API_KEY) in a .env file, then build with npm run build. Start the server standalone with npm start or integrate it with Claude for Desktop by editing claude_desktop_config.json. If environment variables are not set, the server runs in mock mode.

Key features of Spreadsheet MCP Server

Retrieve spreadsheet basic info (list of sheets)
Fetch specific sheet data formatted as markdown tables
Integrate with MCP clients such as Claude for Desktop
Mock mode when Google Apps Script credentials are missing
Avoids Google OAuth flow by using a Google Apps Script Web App

Use cases of Spreadsheet MCP Server

An LLM reading and analyzing data from a Google Sheet
Building an AI assistant that queries spreadsheet content
Automating reports by pulling sheet data into a chat interface
Testing spreadsheet access without real credentials (mock mode)

Frequently asked questions

What runtime dependencies does Spreadsheet MCP Server require?

Node.js and npm are required. The project uses TypeScript and compiles to JavaScript.

How do I set up authentication for the server?

Set the environment variables `GAS_WEB_APP_URL` (the URL of your Google Apps Script Web App) and `GAS_API_KEY` (the API key for accessing that Web App). If not set, the server runs in mock mode.

Where does the spreadsheet data live?

Data remains in the user's Google Sheets. The server accesses it via a Google Apps Script Web App, without storing spreadsheets locally.

How do I change the transport or authentication method?

The server uses MCP over stdio by default. No other transports are mentioned. Authentication is handled via an API key passed to the GAS Web App; no alternative auth methods are documented.

Are there any known limits or restrictions?

The README notes that if environment variables are not set, the server will not access real Google Sheets and returns mock data. No other limits are stated.

Comments

More Other MCP servers

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Codelf

unbug

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

14.2K

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.