AI导哈

Gmail邮件管理服务

基于Dedalus MCP框架的Gmail邮件管理服务，支持邮件、线程、标签、草稿等功能的操作，通过OAuth2进行认证。

  • by annyzhou
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 annyzhou/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 -创建草稿

用法

先决条件

  1. Dedalus API密钥(dsk-live-* 或 dsk-test-*)
  2. 这 dedalus-labs 已安装Python SDK

环境变量

DEDALUS_API_KEY=dsk-live-your-key-here
DEDALUS_API_URL=https://api.dedaluslabs.ai
DEDALUS_AS_URL=https://as.dedaluslabs.ai

客户端示例

看 src/_client.py 查看处理OAuth浏览器流的完整示例客户端。

首次使用MCP服务器时，系统会提示您通过OAuth授权Gmail访问。

OAuth流

  1. 在第一次请求时，您将收到 AuthenticationError 带着一个 connect_url
  2. 在浏览器中打开URL以授权Gmail访问
  3. 授权后，重试请求-凭据现在已存储
  4. 后续请求无需重新授权即可工作

本地开发

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

api参考

相关 MCP