MCP Integration Servers

基本能力

产品定位

MCP_gmail 是一个用于集成 Gmail 和 Google Calendar 服务的 MCP 服务器，旨在通过 Claude Desktop 提供邮件管理和日历操作功能。

核心功能

• Gmail 操作:
• 获取收件箱中的最新邮件
• 使用 Gmail 查询语法搜索邮件
• 读取邮件内容

• 发送邮件（支持 CC 和 BCC）

• 日历操作:

• 搜索日历事件
• 创建新的日历事件
• 查看即将发生的事件

适用场景

• 通过 Claude Desktop 管理 Gmail 邮件
• 通过 Claude Desktop 管理 Google Calendar 事件
• 自动化邮件和日历操作

工具列表

Gmail 工具

• get_latest_emails(max_results: int = 10): 获取收件箱中的最新邮件
• search_emails(query: str, max_results: int = 10): 使用 Gmail 查询语法搜索邮件
• get_email_content(email_id: str): 获取特定邮件的内容
• send_email(to: str, subject: str, body: str, cc: Optional[str], bcc: Optional[str]): 发送邮件

Calendar 工具

• search_events(query: str, max_results: int = 10, time_min: Optional[str]): 搜索日历事件
• create_calendar_event(summary: str, start_time: str, end_time: str, description: Optional[str], location: Optional[str]): 创建新事件

常见问题解答

1. 认证错误:
2. 检查 credentials.json 是否存在
3. 验证 OAuth 令牌的有效性

4. 如果令牌过期，重新认证

5. API 速率限制:

6. 实现指数退避
7. 处理配额超出错误

8. 监控 API 使用情况

9. 连接问题:

10. 检查网络连接
11. 验证 API 端点的可用性
12. 确认防火墙设置

使用教程

使用依赖

1. Python 3.x
2. MCP 包已安装
3. Google Cloud Console 项目已启用 Gmail 和 Calendar API

安装教程

1. OAuth 凭证:
2. 前往 Google Cloud Console
3. 创建新项目或选择现有项目
4. 启用 Gmail API 和 Google Calendar API
5. 创建 OAuth 2.0 凭证

6. 下载凭证并保存为 credentials.json 到项目目录

7. 安装: ```bash # 安装所需包 pip install google-auth-oauthlib google-auth-httplib2 google-api-python-client

# 在 Claude Desktop 中安装服务器 mcp install server.py ```

调试方式

# 使用调试日志运行
export MCP_DEBUG=true
mcp dev server.py

# 不使用调试日志运行
mcp run server.py

许可证

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