Google Sheets MCP

谷歌表格MCP

Google表格的模型上下文协议（MCP）连接器，允许AI代理直接与电子表格交互。

演示

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

设置

1. 克隆此存储库：

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

1. 安装依赖项：

npm install

1. 构建：

npm run build

1. 在Google Cloud Platform中创建OAuth凭据：

- 在中创建新项目 谷歌云控制台 - 启用 谷歌网页API - 配置OAuth同意屏幕 - 使用适当的重定向URI创建OAuth客户端ID凭据（桌面应用程序）（例如：http://localhost:3000/oauth2callback) - 下载凭据并另存为 gcp-oauth.keys.json 在 dist 子目录

1. 启动MCP服务器（必要时会自动提示您验证/重新验证您的Google帐户）：

npm run start

托管/铁路（SSE运输）

如果您需要基于URL的MCP端点（例如，对于Agent Toolkit的“连接到MCP服务器”流），请使用SSE传输运行并部署到Railway等主机：

1. 构建： npm run build
2. 设置环境变量（不提交机密）：

- MCP_TRANSPORT=sse - PORT=3000 （或您平台的端口） - GSHEETS_OAUTH_JSON --您的OAuth客户端JSON（纯文本或base64编码）。如果文件 dist/gcp-oauth.keys.json 不存在。 - GSHEETS_CREDENTIALS_JSON --预授权的JSON证书（纯或base64编码）。使用此选项可避免在托管环境中进行交互式身份验证。

1. 部署 dist/ 到铁路和运行 node dist/index.js.
2. 在客户端/UI中，将MCP URL指向 https://.up.railway.app/sse （服务器将把POST定向到 /messages 通过SSE端点事件）。

注：保留 *.keys.json 以及git中的凭据文件。请改用env变量或主机的机密管理器。

用法

示例配置：

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

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

可用操作

许可证

麻省理工学院