Google 表格与表单 MCP 服务器

一个简单的 MCP 服务器，提供用于处理 Google 表格和 Google 表单的工具、资源和提示。

功能

工具

• list_spreadsheets - 列出你的 Google 表格
• read_sheet - 从 Google 表格读取数据
• write_sheet - 向 Google 表格写入数据
• append_sheet - 追加数据到 Google 表格
• create_spreadsheet - 创建新的表格
• create_form - 创建新的 Google 表单

资源

• sheet://{spreadsheet_id}/{range_name} - 作为资源访问表格数据

提示

• analyze_sheet_data - 分析表格数据的模板
• create_report_template - 创建报告表格的模板
• form_to_sheet - 表单到表格的工作流程模板

配置

1. 创建虚拟环境

cd gsheets-mcp-server
python -m venv .venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

2. 安装依赖项

pip install -r requirements.txt

3. 获取 Google API 凭据

1. 访问 Google Cloud 控制台
2. 创建新项目或选择现有项目
3. 启用以下 API：
   • Google 表格 API
   • Google 表单 API
   • Google 驱动器 API
4. 前往“凭据”→“创建凭据”→“OAuth 客户端 ID”
5. 选择“桌面应用”作为应用程序类型
6. 下载凭据 JSON 文件
7. 将其保存为本目录下的 credentials.json

4. 使用 MCP Inspector 测试服务器

npx @modelcontextprotocol/inspector python gsheets_server.py

Claude Desktop 配置

在你的 Claude Desktop 配置文件中添加以下内容：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gsheets": {
      "command": "python",
      "args": [
        "/FULL/PATH/TO/gsheets-mcp-server/gsheets_server.py"
      ],
      "env": {
        "GOOGLE_CREDENTIALS_PATH": "/FULL/PATH/TO/gsheets-mcp-server/credentials.json"
      }
    }
  }
}

重要: 将 /FULL/PATH/TO/ 替换为该目录的实际绝对路径。

首次运行

首次运行时，服务器会打开浏览器窗口进行 Google 身份验证。授权应用程序后，将创建一个 token.pickle 文件以存储您的凭据供将来使用。

在 Claude Desktop 中的示例用法

配置完成后，您可以向 Claude 发出如下请求：

• “列出我的表格”
• “读取表格 ID 'abc123' 中 'Sheet1!A1:C10' 范围的数据”
• “创建名为 'Q1 报告' 的新表格”
• “追加这些数据到我的表格：[['姓名', '电子邮件'], ['约翰', 'john@example.com']]”
• “使用 analyze_sheet_data 模板”
• “显示表格 'abc123' 的资源”

获取表格 ID

表格 ID 在 URL 中：

https://docs.google.com/spreadsheets/d/SPREADSHEET_ID_HERE/edit

故障排除

• 身份验证失败：删除 token.pickle 并重新运行
• 权限被拒绝：检查是否已在 Google Cloud 控制台启用了 API
• 模块未找到：确保已激活虚拟环境并安装了依赖项