Google Sheets API MCP Server

Google Sheets API MCP Server

site icon
2025.04.11 0
JavaScript电子表格管理数据操作开发者工具交流协作开发效率
Google Sheets API MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,用于与 Google Sheets API 进行交互。该服务提供了管理电子表格、工作表、值和开发者元数据的工具和资源。
View on GitHub

Overview

基本能力

产品定位

Google Sheets API MCP Server 主要用于与 Google Sheets API 进行交互,提供电子表格的管理和操作功能。

核心功能

  • 创建、读取、更新和删除电子表格
  • 管理工作表
  • 读取、写入、追加和清除值
  • 处理开发者元数据
  • 通过 MCP 资源访问电子表格数据

适用场景

  • 团队协作中的电子表格管理
  • 自动化数据处理和更新
  • 开发者元数据的管理

工具列表

Spreadsheet Management

  • createSpreadsheet: 创建新的电子表格
  • getSpreadsheet: 获取电子表格详情
  • batchUpdate: 对电子表格应用多个更新

Sheet Management

  • copySheet: 将工作表复制到另一个电子表格
  • addSheet: 向电子表格添加新工作表
  • deleteSheet: 从电子表格中删除工作表
  • updateSheetProperties: 更新工作表属性

Values Management

  • getValues: 从范围中获取值
  • updateValues: 更新范围中的值
  • appendValues: 向范围追加值
  • clearValues: 清除范围中的值
  • batchGetValues: 从多个范围获取值
  • batchUpdateValues: 更新多个范围中的值

Developer Metadata

  • getDeveloperMetadata: 获取所有开发者元数据
  • createDeveloperMetadata: 创建新的开发者元数据
  • updateDeveloperMetadata: 更新现有的开发者元数据
  • deleteDeveloperMetadata: 删除开发者元数据

常见问题解答

  • 需要提供 OAuth 2.0 凭证(客户端 ID、客户端密钥、刷新令牌)
  • 需要 Google Cloud Platform 项目并启用 Google Sheets API

使用教程

使用依赖

  • Node.js 16 或更高版本
  • Google Cloud Platform 项目并启用 Google Sheets API
  • OAuth 2.0 凭证(客户端 ID、客户端密钥、刷新令牌)

安装教程

  1. 克隆仓库
  2. 安装依赖: npm install
  3. 根据 .env.example 创建 .env 文件并填入 Google API 凭证: CLIENT_ID=your_client_id CLIENT_SECRET=your_client_secret REDIRECT_URI=your_redirect_uri REFRESH_TOKEN=your_refresh_token

调试方式

运行服务器

npm start

开发模式

npm run dev

使用 MCP Inspector 测试

npm run inspect

许可证

该项目遵循 MIT 开源许可条款。