yuppie-mcp-google-sheets

Google Sheets MCP Server — 让 AI 助手通过 MCP 协议操作 Google Sheets 电子表格和 Drive 文件。

特性

• Drive 文件操作：列出文件夹文件、按文件名过滤排序、存储用量查询
• 工作表管理：创建、删除、复制、调整大小、清空
• 数据操作：范围读写、批量写入、区域清除、Visualization API SQL 查询
• 格式设置：筛选器、数据验证（下拉列表）、行高
• 表格管理：创建、删除、查询表格（Table）
• 快捷操作：列过滤、批次索引、批量更新、批量追加、CSV 同步、按批次读取
• 鉴权：基于 Google 服务账号，base64 编码凭据

架构说明

本包是 MCP 壳：核心 Google Sheets 客户端代码在库包 yuppie-google-sheets（PyPI 分发，pip install yuppie-google-sheets），本包依赖它。

如只需在 Python 项目中操作 Google Sheets（不要 MCP），直接装库包：

uv pip install yuppie-google-sheets

快速开始

准备凭据

1. 在 Google Cloud Console 创建服务账号
2. 为该服务账号生成 JSON 密钥
3. 下载 JSON 文件并 base64 编码：

base64 -i your-credentials.json

Claude Code

在 .mcp.json 中添加：

{
  "mcpServers": {
    "google-sheets": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--refresh", "yuppie-mcp-google-sheets"],
      "env": {
        "GOOGLE_CREDENTIALS_B64": "<your-base64-credentials>",
        "GOOGLE_APPS_SCRIPT_URL": "<your_google_apps_script_url_here>"
      }
    }
  }
}

Cursor

在 ~/.cursor/mcp.json 中添加同上配置。

Cherry Studio / Claude Desktop / OpenCode

参照上方 env 字段，按各自 MCP 配置格式填入即可。

环境变量

可用工具（共 28 个）

Drive 文件

工作表管理

数据操作

格式设置

表格管理

快捷操作

测试与调试

uv pip install -e ".[dev]"
uv run pytest -v

使用 MCP Inspector 调试（需先在 .env 配置 GOOGLE_CREDENTIALS_B64）：

npx @modelcontextprotocol/inspector uv run yuppie-mcp-google-sheets

License

MIT