MCP 服务器

Google Sheets MCP

一个模型上下文协议 (MCP) 连接器，允许 AI 代理直接与 Google Sheets 交互，从而能够通过自然语言创建、读取和修改电子表格。

README

Google Sheets MCP

一个用于 Google Sheets 的模型上下文协议 (MCP) 连接器，允许 AI 代理直接与电子表格交互。

演示

https://github.com/user-attachments/assets/cc4729d9-4e6e-437b-848b-6da9a09418c3

设置

克隆此仓库：

git clone https://github.com/mkummer225/google-sheets-mcp
cd google-sheets-mcp

安装依赖项： npm install
构建： npm run build
在 Google Cloud Platform 中创建 OAuth 凭据：
- 在 Google Cloud Console 中创建一个新项目
- 启用 Google Sheets API
- 配置 OAuth 同意屏幕
- 创建 OAuth 客户端 ID 凭据（桌面应用程序），并使用适当的重定向 URI（例如：http://localhost:3000/oauth2callback）
- 下载凭据并将其另存为 gcp-oauth.keys.json 在 dist 子目录中
启动 MCP 服务器（必要时，系统会自动提示您验证/重新验证您的 Google 帐户）： npm run start

用法

示例配置：

{
    "mcpServers": {
    "google-sheets-mcp": {
      "command": "node",
      "args": [
        "/{path_to_dir}/google-sheets-mcp/dist/index.js"
      ]
    }
  }
}

然后，您应该能够简单地指定您的 spreadsheetId，或者让您的代理为您创建一个新的 spreadsheetId。

可用操作

操作	描述
`refresh_auth`	当凭据过期时，重新验证您的 Google 帐户
`list_sheets`	列出 Google 电子表格中的所有工作表/标签
`create_sheet`	在 Google 电子表格中创建一个新的工作表/标签
`create_spreadsheet`	创建一个新的 Google 电子表格
`read_all_from_sheet`	从指定的工作表中读取所有数据
`read_headings`	从工作表中读取列标题
`read_rows`	从工作表中读取特定行
`read_columns`	从工作表中读取特定列
`edit_cell`	编辑工作表中的单个单元格
`edit_row`	编辑工作表中的整行
`edit_column`	编辑工作表中的整列
`insert_row`	在指定位置插入新行
`insert_column`	在指定位置插入新列
`rename_sheet`	重命名电子表格中的工作表/标签
`rename_doc`	重命名 Google 电子表格