mcp-google-sheets: A Google Sheets MCP server

基本能力

产品定位

mcp-google-sheets 是一个用于与 Google Sheets 交互的 MCP 服务器，主要用于电子表格的自动化管理和操作。

核心功能

1. 数据获取：从特定的 Google 电子表格中获取数据。
2. 数据更新：更新电子表格中的单元格数据。
3. 批量更新：批量更新多个范围的单元格数据。
4. 列表功能：列出电子表格中的所有工作表或共享文件夹中的所有电子表格。
5. 创建功能：创建新的电子表格或在工作表中添加新的工作表。
6. 其他工具：包括添加行、添加列、复制工作表、重命名工作表等。

适用场景

1. 自动化数据处理：自动从电子表格中获取数据或更新数据。
2. 批量操作：批量更新多个电子表格或工作表中的数据。
3. 电子表格管理：创建、管理和组织电子表格和工作表。
4. 数据集成：将 Google Sheets 数据集成到其他应用程序或服务中。

工具列表

1. get_sheet_data：从特定的 Google 电子表格中获取数据。
2. update_cells：更新电子表格中的单元格数据。
3. batch_update_cells：批量更新多个范围的单元格数据。
4. list_sheets：列出电子表格中的所有工作表。
5. list_spreadsheets：列出共享文件夹中的所有电子表格。
6. create_spreadsheet：创建新的电子表格。
7. create_sheet：在现有的电子表格中创建新的工作表。
8. 其他工具：add_rows, add_columns, copy_sheet, rename_sheet。

常见问题解答

1. 认证问题：服务器支持两种认证方式，服务账户认证（推荐）和 OAuth 2.0 认证。
2. 环境变量设置：需要正确设置环境变量以启用相应的认证方式。
3. 运行问题：可以使用 uvx 直接运行服务器，或通过 uv 进行开发和修改。

使用教程

使用依赖

1. Google Cloud Platform 设置：
2. 创建 Google Cloud Platform 项目。

3. 启用 Google Sheets API 和 Google Drive API。

4. 认证方法选择：

5. 服务账户认证（推荐）： bash export SERVICE_ACCOUNT_PATH=/path/to/your/service-account-key.json export DRIVE_FOLDER_ID=your_shared_folder_id_here
6. OAuth 2.0 认证： bash export CREDENTIALS_PATH=/path/to/your/credentials.json export TOKEN_PATH=/path/to/your/token.json

安装教程

1. 使用 uvx 运行（推荐）： bash uvx mcp-google-sheets

2. 开发和修改： bash git clone https://github.com/yourusername/mcp-google-sheets.git cd mcp-google-sheets uv run mcp-google-sheets

调试方式

1. 认证过程：服务器会自动选择认证方式，优先使用服务账户认证，失败后回退到 OAuth 流程。
2. 日志查看：检查环境变量设置和认证文件路径是否正确。
3. 示例提示：使用 Claude 连接服务器后，可以尝试以下命令：
4. "List all spreadsheets in my shared folder"
5. "Create a new spreadsheet titled 'Budget 2024'"
6. "Get the data from Sheet1 in my spreadsheet with ID 1A2B3C4D5E6F7G8H"

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。