Spreadsheet MCP Server

Name: Spreadsheet MCP Server
Author: Ryo-Muramatsu

@Ryo-Muramatsu

代码仓库

关于 Spreadsheet MCP Server

暂无概览

#mcp-server #spreadsheet #mcp

基本信息

分类

其他

运行时

node

传输方式

stdio

发布者

Ryo-Muramatsu

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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).