Spreadsheet MCP Server logo

Spreadsheet MCP Server

by MCP-Mirror

This project is a Model Context Protocol (MCP) server designed to access data from Google Spreadsheets. It enables Large Language Models (LLMs) to directly utilize spreadsheet information.

View on GitHub

Last updated: N/A

What is Spreadsheet MCP Server?

The Spreadsheet MCP Server is a tool that allows LLMs to interact with and retrieve data from Google Spreadsheets using the Model Context Protocol. It acts as a bridge between the LLM and the spreadsheet, providing structured access to the data.

How to use Spreadsheet MCP Server?

To use the server, you need to clone the repository, install dependencies, configure environment variables (GAS_WEB_APP_URL and GAS_API_KEY) to connect to your Google Apps Script Web App, build the project, and then run it. It can be integrated with Claude for Desktop by adding a configuration entry. You can also test it with the MCP Inspector.

Key features of Spreadsheet MCP Server

  • Retrieves basic spreadsheet information (e.g., sheet list)

  • Retrieves data from specific sheets and formats it as Markdown

  • Integrates with MCP clients like Claude for Desktop

  • Supports both standalone operation and integration with other applications

  • Includes mock mode for testing without accessing actual Google Spreadsheets

Use cases of Spreadsheet MCP Server

  • Enabling LLMs to answer questions based on spreadsheet data

  • Automating data analysis and reporting using LLMs

  • Building applications that require real-time access to spreadsheet information

  • Integrating spreadsheet data into conversational AI workflows

FAQ from Spreadsheet MCP Server

What is GAS_WEB_APP_URL?

It's the URL of your Google Apps Script Web App that provides access to the spreadsheet data.

What is GAS_API_KEY?

It's the API key used to authenticate access to your Google Apps Script Web App.

How do I set up the Google Apps Script Web App?

You need to create a Google Apps Script project, implement an API to access your spreadsheet data, and deploy it as a Web App. Refer to the api/README.md file for API specifications.

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

The server will run in mock mode and return test data instead of accessing a real Google Spreadsheet.

How do I test the server?

You can use the MCP Inspector tool to test the server's functionality and ensure it's working correctly.