使用说明
Gmail刀片MCP
为AI代理生产Gmail MCP服务器。令牌高效、写安全、线程智能。
特性
| 类别 | 工具 | 描述 |
|---|---|---|
| 阅读 | gmail_search, gmail_read, gmail_snippets, gmail_thread, gmail_mailboxes |
搜索、阅读消息和帖子、列出标签 |
| 元 | gmail_info, gmail_state, gmail_changes, gmail_identities, gmail_filters |
帐户信息、增量同步、以别名发送、过滤规则 |
| 写 | gmail_send, gmail_reply, gmail_draft, gmail_flag, gmail_move, gmail_bulk, gmail_delete |
发送、回复、草稿、标签、移动、批量操作、删除 |
| 过滤器 | gmail_filter_create, gmail_filter_delete |
创建和删除Gmail过滤器 |
| 人工智能 | gmail_classify, gmail_summarise |
Gemini动力分类和总结（要求 GOOGLE_API_KEY) |
这有什么不同
- 默认情况下令牌有效 --HTML→明文剥离、正文截断、引用回复重复、简洁列表格式
- 安全写入 —
GMAIL_WRITE_ENABLED=true环境门+confirm=true关于破坏性行动 - 线程智能 —
thread_mode=deduped条带引用回复；latest仅显示最新消息 - 增量同步 —
gmail_state+gmail_changes通过Gmailhistory.listAPI - 了解费率限制 --429个错误的自动指数回退
- 双子座人工智能 --使用Google Gemini对电子邮件进行分类和总结（可选，需要
GOOGLE_API_KEY) - 凭证安全 --从错误消息中删除OAuth令牌
快速开始
1.安装
uv sync
2.设置Gmail API凭据
- 首选 谷歌云控制台
- 创建项目（或选择现有项目）
- 启用Gmail API
- 创建OAuth 2.0凭据（桌面应用程序）
- 下载JSON文件
- 另存为
~/.gmail-blade/credentials.json
3.首次运行（验证）
uv run gmail-blade-mcp
浏览器窗口打开以获取OAuth同意。授权后，刷新令牌将保存到 ~/.gmail-blade/token.json.
4.配置MCP客户端
克劳德桌面 (claude_desktop_config.json):
{
"mcpServers": {
"gmail-blade": {
"command": "uv",
"args": ["--directory", "/path/to/gmail-blade-mcp", "run", "gmail-blade-mcp"],
"env": {
"GMAIL_WRITE_ENABLED": "false"
}
}
}
}
环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
GMAIL_WRITE_ENABLED |
false |
启用写入操作（发送、回复、删除等） |
GMAIL_MCP_TRANSPORT |
stdio |
运输： stdio 或 http |
GMAIL_MCP_HOST |
127.0.0.1 |
HTTP主机（当传输=HTTP时） |
GMAIL_MCP_PORT |
8768 |
HTTP端口（当传输=HTTP时） |
GMAIL_MCP_API_TOKEN |
（无） | HTTP传输身份验证的承载令牌 |
GOOGLE_API_KEY |
（无） | Gemini分类/总结工具的Google AI Studio API密钥 |
安全
- 默认情况下禁用写入操作 --set
GMAIL_WRITE_ENABLED=true启用 - 永久删除需要
confirm=true--使用gmail_move到TRASH进行软删除 - OAuth令牌永远不会出现在错误消息中 --对所有错误路径进行正则表达式清理
- 承载身份验证使用恒定时间比较 —
secrets.compare_digest() - 本地存储的凭据 —
~/.gmail-blade/，从未传输
发展
make install-dev # Install with dev + test deps
make test # Unit tests (no Gmail needed)
make check # Lint + format + type check
make test-cov # Tests with coverage
email-v1合同
此服务器实现Sidereal email-v1 域契约——与 fastmail-blade-mcp.技能定位 email-v1 与任何一家供应商合作。
许可证
麻省理工学院
