Gmail邮件管理服务

一个基于OAuth2认证的Gmail邮件管理服务,提供邮件、线程、标签、草稿和用户资料的管理功能。

  • by windsornguyen
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 windsornguyen/gmail-mcp

使用说明

gmail mcp

通过Dedalus MCP框架使用OAuth2承载令牌认证的Gmail MCP服务器。

工具

消息

  • gmail_list_messages -列出带有搜索查询的邮件
  • gmail_get_message -按ID获取特定消息
  • gmail_send_message -发送电子邮件
  • gmail_trash_message -将邮件移至垃圾箱
  • gmail_untrash_message -从垃圾箱中删除邮件
  • gmail_modify_message -添加/删除邮件上的标签

线程

  • gmail_list_threads -列出电子邮件线程(对话)
  • gmail_get_thread -获取包含所有消息的帖子
  • gmail_trash_thread -将线程移到垃圾桶

标签

  • gmail_list_labels -列出所有标签
  • gmail_get_label -获取标签详细信息
  • gmail_create_label -创建新标签
  • gmail_delete_label -删除用户标签

草稿

  • gmail_list_drafts -列出电子邮件草稿
  • gmail_get_draft -按ID获取草稿
  • gmail_create_draft -创建草稿
  • gmail_send_draft -发送草稿
  • gmail_delete_draft -删除草稿

个人资料

  • gmail_get_profile -获取用户的Gmail个人资料

认证

Gmail API需要OAuth2。访问令牌在运行时通过Dedalus凭证交换提供。

所需的OAuth作用域(取决于操作):

  • https://www.googleapis.com/auth/gmail.readonly -只读访问
  • https://www.googleapis.com/auth/gmail.send -发送电子邮件
  • https://www.googleapis.com/auth/gmail.modify -修改消息/标签
  • https://www.googleapis.com/auth/gmail.compose -创建草稿

本地开发

cd gmail-mcp
uv sync
uv run python src/main.py

api参考