Google Sheets MCP Server

基本能力

产品定位

Google Sheets MCP Server 是一个连接 Claude Desktop 和 Google Sheets 的中间件，旨在提升用户通过 Claude Desktop 操作 Google Sheets 的效率和便捷性。

核心功能

• 创建新的 Google Sheets
• 读取和写入现有表格数据
• 格式化单元格和范围
• 添加和删除工作表
• 写入公式
• 搜索工作表
• 列出可用工作表

适用场景

• 通过 Claude Desktop 自动化管理 Google Sheets
• 批量处理表格数据
• 自动化报表生成
• 团队协作中的数据同步

工具列表

• create_sheet(title: str): 创建新表格
• format_range(file_id: str, range: str, format: dict): 格式化单元格范围
• write_formula(file_id: str, range: str, formula: str): 写入公式
• add_sheet(file_id: str, title: str): 添加工作表
• delete_sheet(file_id: str, sheet_id: int): 删除工作表
• get_sheet_properties(file_id: str): 获取工作表属性

常见问题解答

1. 服务器连接问题
2. 检查服务器是否运行
3. 验证配置中的凭证路径

4. 查看 Claude Desktop 日志

5. 认证问题

6. 确保 OAuth 凭证有效
7. 检查是否添加为测试用户

8. 尝试删除 token.json 并重新认证

9. API 错误

10. 确认 Google Sheets API 已启用
11. 检查 API 配额和限制
12. 查看错误日志获取具体信息

使用教程

使用依赖

• Python 3.10 或更高版本
• 已启用 Google Sheets API 的 Google Cloud 项目
• Google Cloud Console 的 OAuth 2.0 凭证
• Claude Desktop 应用程序
• uv 包管理器（推荐）

安装教程

1. 克隆仓库:

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

1. 创建并激活虚拟环境:

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

1. 使用 uv 安装依赖:

uv pip install -e .

1. 设置 Google Cloud 凭证:
2. 访问 Google Cloud Console
3. 创建新项目或选择现有项目
4. 启用 Google Sheets API 和 Google Drive API
5. 创建 OAuth 2.0 凭证（桌面应用）
6. 下载凭证并保存为 ~/.config/google_sheets_mcp/google-sheets-mcp.json

调试方式

1. 手动运行服务器完成 OAuth 认证:

python google_sheets.py --credentials-path ~/.config/google_sheets_mcp/google-sheets-mcp.json

1. 按照浏览器提示授权应用
2. 令牌将自动保存供以后使用

许可证

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