AI导哈

Google表格与表单管理工具

一个提供Google Sheets和Google Forms操作工具的MCP服务器，支持表格数据读写、表单创建及模板应用。

  • by hellotinah
  • Python
  • 本地部署
  • 36 星标
  • 更新于
在 GitHub 查看 hellotinah/MCP

使用说明

Google Sheets & Forms MCP 服务器

一个简单的MCP服务器，提供工具、资源和提示，用于与Google Sheets和Google Forms协作。

特性/功能

工具

  • 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  # On Windows: .venv\Scripts\activate

2. 安装依赖项

pip install -r requirements.txt

3. 获取Google API凭据

  1. 首选 Google Cloud 控制台
  2. 创建一个新项目或选择一个现有项目
  3. 启用以下API：
    • Google Sheets API
    • 谷歌表单API
    • 谷歌云端硬盘API
  4. 前往“凭据”→“创建凭据”→“OAuth 客户端 ID”
  5. 选择“桌面应用程序”作为应用程序类型
  6. 下载凭证JSON文件
  7. 将其另存为 credentials.json 在这个目录中

4. 使用MCP Inspector测试服务器

npx @modelcontextprotocol/inspector python gsheets_server.py

Claude 桌面配置

将此添加到您的Claude桌面配置文件中：

macOS（发音为“Mac OS”，全称为“Macintosh Operating System”，即“苹果电脑操作系统”）： ~/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桌面版中的示例用法

配置完成后，您可以向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 Console 中启用了 API
  • 模块未找到确保虚拟环境已激活且依赖项已安装

相关 MCP