AI导哈

Gmail邮件操作工具

基于FastMCP构建的Gmail MCP服务器，提供19种工具用于电子邮件操作、标签管理、过滤器管理和附件处理。

  • by jeffmm
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 jeffmm/gmail-fast-mcp

使用说明

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/oauth2callback

3.运行服务器

uv run python -m gmail_fast_mcp

MCP客户端配置

{
  "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 --管理过滤器和设置

相关 MCP