gmail快速mcp
Gmail MCP服务器内置 FastMCP.通过Gmail API提供19种用于电子邮件操作、标签管理、过滤器管理和附件处理的工具。
设置
1.谷歌OAuth凭据
将您的Google Cloud OAuth客户端凭据放置在 ~/.gmail-mcp/gcp-oauth.keys.json （或者在项目目录中——它们将被自动复制）。
2.身份验证
uv run python -m gmail_fast_mcp auth这将打开OAuth流的浏览器，并将令牌保存到 ~/.gmail-mcp/credentials.json.
对于具有自定义回调URL的云环境：
uv run python -m gmail_fast_mcp auth https://your-domain.com/oauth2callback3.运行服务器
uv run python -m gmail_fast_mcpMCP客户端配置
{
"mcpServers": {
"gmail": {
"command": "uv",
"args": ["run", "--directory", "/path/to/gmail-fast-mcp", "python", "-m", "gmail_fast_mcp"]
}
}
}工具
| 工具 | 说明 |
|---|---|
send_email | 发送电子邮件（文本/html/多部分、附件、线程） |
draft_email | 创建电子邮件草稿 |
read_email | 检索电子邮件内容和附件元数据 |
search_emails | 使用Gmail查询语法进行搜索 |
modify_email | 添加/删除邮件上的标签 |
trash_email | 将邮件移至垃圾箱 |
batch_modify_emails | 修改多封邮件上的标签 |
batch_trash_emails | 回收多封邮件 |
list_email_labels | 列出所有Gmail标签 |
create_label | 创建新标签 |
update_label | 更新标签名称/可见性 |
delete_label | 删除用户标签 |
get_or_create_label | 查找现有标签或创建它 |
create_filter | 使用自定义条件/操作创建筛选器 |
list_filters | 列出所有筛选器 |
get_filter | 获取过滤器详细信息 |
delete_filter | 删除筛选器 |
create_filter_from_template | 从预设模板创建筛选器 |
download_attachment | 将附件下载到磁盘 |
Gmail API范围
gmail.modify--阅读、发送、修改电子邮件和标签gmail.settings.basic--管理过滤器和设置