MCP Gmail Server

基本能力

产品定位

MCP Gmail Server 是一个为 LLMs 提供 Gmail 访问和邮件管理功能的 MCP 服务。

核心功能

• 将 Gmail 消息作为 MCP 资源暴露
• 提供邮件撰写、发送和管理工具
• 支持 Google Gmail API 的 OAuth 2.0 认证

适用场景

• 通过 LLMs 自动化处理 Gmail 邮件
• 集成 Gmail 功能到其他应用程序中
• 开发基于邮件的自动化工作流

工具列表

• compose_email: 创建新邮件草稿
• send_email: 发送邮件
• search_emails: 根据特定条件搜索邮件
• query_emails: 使用原始 Gmail 查询语法搜索邮件
• get_emails: 通过 ID 检索多个邮件
• list_available_labels: 获取所有可用的 Gmail 标签
• mark_message_read: 标记邮件为已读
• add_label_to_message: 为邮件添加标签
• remove_label_from_message: 移除邮件的标签

常见问题

• 需要确保正确配置 Google Cloud 项目和 OAuth 凭证
• 可能需要更新 Claude Desktop 配置以提供 uv 的绝对路径
• 需要 Python 3.10+ 环境

使用教程

使用依赖

• Python 3.10+
• Gmail 账户并启用 API 访问
• uv (推荐的 Python 包管理工具)

安装依赖命令:

uv sync

安装教程

1. 配置 Gmail OAuth 凭证
2. 创建 Google Cloud 项目
3. 启用 Gmail API
4. 配置 OAuth 同意屏幕
5. 创建 OAuth 凭证并下载 credentials.json

6. 添加必要的 Gmail API 作用域

7. 运行测试脚本验证配置

uv run python scripts/test_gmail_setup.py

1. 运行服务器 开发模式:

uv run mcp dev mcp_gmail/server.py

安装到 Claude Desktop:

uv run mcp install \
    --with-editable .
    --name gmail \
    --env-var MCP_GMAIL_CREDENTIALS_PATH=$(pwd)/credentials.json \
    --env-var MCP_GMAIL_TOKEN_PATH=$(pwd)/token.json \
    mcp_gmail/server.py

调试方式

运行测试:

uv run pytest tests/

代码格式化:

uv run ruff format .

代码检查:

uv run ruff check --fix .

预提交钩子:

pre-commit install
pre-commit run --all-files

许可证

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