Spreadsheet MCP Server

What is Spreadsheet MCP Server?

Spreadsheet MCP Server is a Model Context Protocol (MCP) server that provides LLMs with direct access to Google Spreadsheet data. It retrieves spreadsheet information and sheet data, formatting the output as markdown for use by MCP clients such as Claude for Desktop.

How to use Spreadsheet MCP Server?

Clone the repository, install dependencies with npm install, copy .env.example to .env, set GAS_WEB_APP_URL and GAS_API_KEY, then run npm run build and npm start. For integration with Claude for Desktop, add the server configuration to claude_desktop_config.json.

Key features of Spreadsheet MCP Server

• Retrieves spreadsheet basic info and sheet list
• Fetches specific sheet data as markdown tables
• Integrates with MCP clients like Claude for Desktop
• Operates in mock mode when environment variables are unset

Use cases of Spreadsheet MCP Server

• Let an LLM browse sheet names and structure in a spreadsheet
• Provide an LLM with formatted data from a specific sheet for analysis
• Enable conversational querying of spreadsheet contents via Claude for Desktop

FAQ from Spreadsheet MCP Server

How does data access and authentication work?

The server connects to a Google Apps Script Web App using a URL and API key set in environment variables. This avoids a full Google OAuth flow while maintaining spreadsheet security.

What happens if I don't set the environment variables?

If GAS_WEB_APP_URL and GAS_API_KEY are not configured, the server runs in mock mode and returns test data instead of real spreadsheet content.

What tools does the server provide?

It provides two tools: getSpreadsheet (returns spreadsheet name, ID, and sheet list with row/column counts) and getSheetData (returns the contents of a specific sheet as a markdown table).