Gmail MCP Server

基本能力

产品定位

Gmail MCP Server 是一个集成Gmail和Google Calendar的智能助手，旨在通过上下文感知技术优化电子邮件管理和日程安排。

核心功能

• 深度邮件分析：提供完整对话线程的上下文分析
• 上下文感知响应：基于完整通信历史生成响应
• 智能行动建议：分析邮件内容，建议日历事件、任务和跟进事项
• 日历集成：检测邮件中的事件并创建自然语言支持的日历条目
• 高级搜索：支持语义理解的邮件历史搜索
• 个性化：根据与特定联系人的沟通风格进行适配

适用场景

• 高效管理电子邮件收件箱
• 智能回复电子邮件
• 自动检测和创建日历事件
• 基于上下文的邮件搜索和分析

工具列表

• Email Management：提供收件箱概览、高级搜索和详细邮件分析
• Context-Aware Email Replies：智能回复准备、通信模式分析和个性化草稿
• Calendar Integration：事件创建、事件检测和日历管理
• Smart Scheduling：基于电子邮件对话的智能会议安排

常见问题解答

• 认证问题：检查token文件、Google Cloud Console项目设置和OAuth同意屏幕
• 日历API问题：确保Calendar API已启用，并重新认证以授予必要的范围
• MCP连接问题：重启Claude Desktop或手动请求使用Gmail MCP服务器

使用教程

使用依赖

• Python 3.10+
• Google Cloud Platform账户，已启用Gmail API和Google Calendar API
• OAuth 2.0凭证
• 支持MCP的Claude Desktop

安装教程

通过Smithery安装

npx -y @smithery/cli install @bastienchabal/gmail-mcp --client claude

手动安装

1. 克隆仓库

git clone https://github.com/bastienchabal/gmail-mcp.git
cd gmail-mcp

1. 设置虚拟环境

pip install uv
uv venv
source .venv/bin/activate

1. 安装依赖

uv pip install -e .

调试方式

• 测试认证过程

python debug/auth_test.py

• 重新认证Calendar API

python debug/reauth_calendar.py

许可证

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