MCP Sheets

@mcp-z/mcp片材

文件：https://mcp-z.github.io/mcp-sheets 用于读取、写入和格式化电子表格的Google Sheets MCP服务器。

常见用途

• 查找电子表格和表格
• 添加和更新数据
• 应用格式、验证和图表

运输

MCP支持stdio和HTTP。

工作室

{
  "mcpServers": {
    "sheets": {
      "command": "npx",
      "args": ["-y", "@mcp-z/mcp-sheets"]
    }
  }
}

超文本传输协议

{
  "mcpServers": {
    "sheets": {
      "type": "http",
      "url": "http://localhost:9004/mcp",
      "start": {
        "command": "npx",
        "args": ["-y", "@mcp-z/mcp-sheets", "--port=9004"]
      }
    }
  }
}

start 是由使用的扩展名 npx @mcp-z/cli up 为您启动HTTP服务器。

创建Google Cloud应用程序

1. 首选 谷歌云控制台.
2. 创建或选择一个项目。
3. 启用Google Sheets API。
4. 创建OAuth 2.0凭据（桌面应用程序）。
5. 复制客户端ID和客户端密码。
6. 选择您的MCP传输（stdio用于本地，http用于远程）和平台

• 对于stdio，选择“API和服务”，+创建客户端，“桌面应用程序”类型
• 对于http，选择“API和服务”，+创建客户端，“Web应用程序”类型，添加您的URL（默认为http://localhost:3000/oauth/callback基于--port或port）
• 对于本地主机，添加“http://127.0.0.1“为 临时重定向URL

1. 启用OAuth2 范围：openidhttps://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive
2. 添加 测试电子邮件

OAuth模式

通过环境变量或 env 把…的车堵住 .mcp.json。参见 server.json 查看完整的选项列表。

环回OAuth（默认）

环境变量：

GOOGLE_CLIENT_ID=your-client-id
GOOGLE_CLIENT_SECRET=your-client-secret

示例（stdio）-创建.mcp.json：

{
  "mcpServers": {
    "sheets": {
      "command": "npx",
      "args": ["-y", "@mcp-z/mcp-sheets"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id"
      }
    }
  }
}

示例（http）-创建.mcp.json：

{
  "mcpServers": {
    "sheets": {
      "type": "http",
      "url": "http://localhost:3000",
      "start": {
        "command": "npx",
        "args": ["-y", "@mcp-z/mcp-sheets", "--port=3000"],
        "env": {
          "GOOGLE_CLIENT_ID": "your-client-id"
        }
      }
    }
  }
}

本地（默认）：省略信用URI→临时环回。 Cloud：将REDIRECT_URI设置为您的public/oauth/回调，并公开该服务。

注意：start块是“npx@mcp-z/cli-up”中的一个助手，用于从.mpc.json启动http服务器。看 @mcp-z/cli 了解详情。

服务帐户

环境变量：

AUTH_MODE=service-account
GOOGLE_SERVICE_ACCOUNT_KEY_FILE=/path/to/service-account.json

例子：

{
  "mcpServers": {
    "sheets": {
      "command": "npx",
      "args": ["-y", "@mcp-z/mcp-sheets", "--auth=service-account"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_KEY_FILE": "/path/to/service-account.json"
      }
    }
  }
}

DCR（自托管）

仅限HTTP。需要一个公共基础URL。

{
  "mcpServers": {
    "sheets-dcr": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-z/mcp-sheets",
        "--auth=dcr",
        "--port=3456",
        "--base-url=https://oauth.example.com"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

如何使用

# List tools
mcp-z inspect --servers sheets --tools

# Find a spreadsheet
mcp-z call sheets spreadsheet-find '{"spreadsheetRef":"Quarterly Report"}'

工具

1. 单元格格式
2. 图表创建
3. 列得到
4. 列更新
5. csv获取列
6. 尺寸批量更新
7. 尺寸移动
8. 行追加
9. csv行追加
10. 行得到
11. 纸张副本
12. 纸张复制到
13. 图纸创建
14. 工作表删除
15. 工作表查找
16. 图纸重命名
17. 电子表格副本
18. 电子表格创建
19. 电子表格查找
20. 电子表格重命名
21. 验证集
22. 值批量更新
23. 值明确
24. csv值更新
25. 值替换
26. 值搜索

资源

1. 电子表格

提示

1. a1符号

配置参考

看 server.json 对于所有支持的环境变量、CLI参数和默认值。