Enables complete email management through Gmail, including sending emails with attachments, reading and searching emails, managing labels and organization, handling drafts, and performing batch operations on multiple emails.
Integrates with Google Cloud for authentication and API access, allowing the MCP server to securely connect to Gmail services through OAuth 2.0 credentials.
强大的模型上下文协议 (MCP) 服务器，使 Claude AI 能够直接与 Gmail 交互。
Gmail MCP 服务器是一个全面的实现，它使像 Claude 这样的 AI 助手能够通过自然语言直接与 Gmail 交互。它提供了一套丰富的电子邮件管理工具，实现了对话式 AI 与收件箱的无缝集成。
credentials.json运行服务器一次以进行身份验证：
这将打开一个浏览器窗口，要求您使用 Google 帐户进行身份验证。身份验证完成后，将创建并保存一个token.json文件以供将来使用。
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json**注意：**将"/absolute/path/to/gmail-mcp-server/gmail_server.py"替换为克隆存储库中gmail_server.py文件的实际绝对路径。
Gmail MCP 服务器向 Claude 公开了以下工具：
send_email - 发送包含文本/HTML 内容的基本电子邮件send_email_with_attachment - 发送带有文件附件的电子邮件send_email_with_multiple_attachments - 发送带有多个附件的电子邮件read_email - 根据 ID 读取特定电子邮件的内容get_unread_emails - 获取未读电子邮件列表get_important_emails - 获取标记为重要的电子邮件get_emails_with_attachments - 获取带有附件的电子邮件get_recent_emails - 获取过去 X 天的电子邮件search_emails - 使用 Gmail 的查询语法搜索电子邮件get_email_labels - 列出所有 Gmail 标签/文件夹create_email_label - 创建新标签delete_email_label - 删除现有标签label_email - 将标签应用于电子邮件remove_email_label - 从电子邮件中删除标签mark_as_read - 将电子邮件标记为已读mark_as_unread - 将电子邮件标记为未读delete_email - 将电子邮件移至垃圾箱create_email_draft - 创建新的电子邮件草稿update_email_draft - 更新现有草稿list_email_drafts - 列出可用的草稿send_draft - 发送现有草稿batch_apply_label - 将标签应用于多封电子邮件batch_delete_emails - 将多封电子邮件移至垃圾箱get_email_profile - 获取 Gmail 个人资料信息summarize_recent_emails最近的电子邮件 - 创建最近电子邮件的摘要以下是针对 Claude 的一些示例提示：
服务器支持多种环境变量进行定制：
| 多变的 | 描述 |
|---|---|
GMAIL_TOKEN_PATH | 存储 OAuth 令牌的自定义路径 |
GMAIL_CREDENTIALS_PATH | OAuth 凭证的自定义路径 |
GOOGLE_CLIENT_ID | OAuth 客户端 ID（凭证文件的替代） |
GOOGLE_CLIENT_SECRET | OAuth 客户端密钥（凭证文件的替代） |
MCP_PORT | SSE 传输端口（默认值：3000） |
DEBUG | 启用调试模式（ true或false ） |
服务器可以在 SSE（服务器发送事件）模式下运行，以实现基于 HTTP 的集成：
这将在指定端口（默认值：3000）上启动服务器，使其可以通过 HTTP 访问。
欢迎贡献代码！欢迎提交 Pull 请求。
git checkout -b feature/amazing-feature ）git commit -m 'Add some amazing feature' ）git push origin feature/amazing-feature ）该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。