MCP Google Sheets Server

Name: MCP Google Sheets Server
Author: shionhonda

本地服务

github.com/shionhonda数据与分析381 周前更新

代码仓库

关于 MCP Google Sheets Server

MCP Google Sheets Server 为需要查看或更新 Google Sheets 的客户端提供表格内容操作。它支持列出工作表标签以及读写单元格区域，但不管理 Google Drive 文件。

主要功能

01列出电子表格工作表
02读取单元格区域
03写入单元格区域
04仅访问电子表格内容

适用场景

01查看电子表格包含哪些标签页
02读取指定区域中的值
03用二维值列表更新单元格

MCP 相关

该 MCP 服务提供列出工作表以及读写 Google Sheets 单元格区域的工具，不提供 Google Drive 文件管理功能。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

MCP Google Sheets 服务

本项目提供一个 Model Context Protocol（MCP）服务，可与 Google Sheets 交互。

它提供以下工具：

列出电子表格中的工作表（标签页）。
读取指定单元格范围内的数据。
向指定单元格范围写入数据。

它明确不提供用于管理 Google Drive 文件（列出、创建、删除文件夹/文件）的工具。访问权限仅限于电子表格内容。

前提条件

Python 3.11+
已启用 Google Sheets API 的 Google Cloud 项目
服务账号密钥：
- 前往 Google Cloud Console 并创建一个新的服务账号。
- 下载服务账号密钥文件（JSON 格式）。
- 为该服务账号授予你要访问的 Google Sheets 的“Editor”角色。

使用方法

克隆代码库。

git clone https://github.com/shionhonda/mcp-gsheet.git

设置 Google 凭据：
- 将 GOOGLE_APPLICATION_CREDENTIALS 环境变量设为已下载的服务账号 JSON 密钥文件的_绝对路径_。
```
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/service-account-key.json"
```
- 或者，也可以将密钥文件放在 Google Cloud 客户端库认可的标准位置（不建议在共享环境中这样做）。
安装依赖项：
```
uv venv
source .venv/bin/activate
```
运行服务

使用 MCP Inspector 开发服务：
```
mcp dev server.py
```
运行服务：
```
mcp run server.py
```
服务将启动，并通过标准输入/输出（stdio）监听 MCP 请求。

Claude Desktop

将以下内容添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "gsheet": {
      "command": "/path/to/uv",
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account-key.json"
      },
      "args": ["--directory", "/path/to/mcp-gsheet", "run", "server.py"]
    }
  }
}

提供的 MCP 工具

list_sheets(spreadsheet_id: str) -> list[str]：列出指定电子表格中所有工作表的名称。
read_cells(spreadsheet_id: str, range_name: str) -> list[list[str]]：读取给定范围内的数据（例如，'Sheet1!A1:B5'）。
write_cells(spreadsheet_id: str, range_name: str, values: list[list[str]]) -> str：将提供的二维值列表写入指定起始单元格/范围（例如，'Sheet1!C1'）。