Google Workspace MCP Servers
2025.01.05
1
Python邮件管理日历管理文件管理交流协作日程管理
Google Workspace MCP Servers 是一组通过大型语言模型（如Claude）安全访问Google Workspace服务的模型上下文协议（MCP）服务器。该项目包含三个独立的服务器：Gmail MCP Server、Calendar MCP Server和Drive MCP Server，分别用于管理电子邮件、日历事件和文件。
View on GitHub
Overview
基本能力
产品定位
Google Workspace MCP Servers 提供通过大型语言模型安全访问Google Workspace服务的能力，包括Gmail、Calendar和Drive的管理功能。
核心功能
- Gmail MCP Server: 搜索电子邮件、阅读内容和管理标签
- Calendar MCP Server: 查看事件和检查可用性
- Drive MCP Server: 搜索和组织文件及文件夹
适用场景
- 通过自然语言查询管理电子邮件
- 查看和安排日历事件
- 搜索和组织Google Drive中的文件
工具列表
- Gmail Server:
search_emails: 使用Gmail的查询语法搜索电子邮件apply_label: 为电子邮件应用或创建标签- Calendar Server:
check_availability: 检查给定日期的空闲/忙碌状态- Drive Server:
search_files: 搜索文件和文件夹move_file: 在文件夹之间移动文件
常见问题解答
- 认证问题: 检查
client_secrets.json文件位置，删除token_*.pickle文件强制重新认证 - 服务器连接问题: 检查Claude日志，验证路径配置，确保虚拟环境已激活
- 常见错误消息: "Failed to start server"、"Authentication failed"、"API not enabled"
使用教程
使用依赖
- Windows 10或更高版本
- Python 3.10+
- Node.js（需要
npx） - Claude Desktop
- 具有OAuth 2.0凭证的Google Cloud项目
安装教程
- Google Cloud设置:
- 创建或选择项目
- 启用Gmail API、Google Calendar API和Google Drive API
- 配置OAuth 2.0凭证
- 项目设置: ```powershell # 创建项目目录 uv init google-workspace-mcp cd google-workspace-mcp
# 创建并激活虚拟环境 uv venv .venv\Scripts\activate
# 安装所需包
uv add mcp[cli] google-api-python-client google-auth-httplib2 google-auth-oauthlib
``
3. **配置Claude Desktop**:
- 编辑配置并替换为claude_config.json`文件内容
调试方式
- 查看实时日志:
powershell Get-Content -Path "%APPDATA%\Claude\logs\mcp*.log" -Wait - 日志位置:
%APPDATA%\Claude\logs\mcp-server-gmail.log%APPDATA%\Claude\logs\mcp-server-calendar.log%APPDATA%\Claude\logs\mcp-server-drive.log