Gmail MCP Server

Gmail MCP Server

site icon
2025.04.15 0
TypeScript邮件管理Gmail API 集成交流协作
Gmail MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,提供与 Gmail API 交互的工具。该服务允许用户通过 MCP 接口以编程方式管理电子邮件。
View on GitHub

Overview

基本能力

产品定位

Gmail MCP Server 是一个用于管理 Gmail 电子邮件的编程接口服务,提供了一系列工具来操作 Gmail 账户中的邮件。

核心功能

  • Gmail 工具
  • list_emails: 列出收件箱中的最近邮件,支持可选过滤
  • search_emails: 使用 Gmail 查询语法进行高级邮件搜索
  • send_email: 发送新邮件,支持 CC 和 BCC
  • modify_email: 修改邮件标签(归档、删除、标记已读/未读)

适用场景

  • 自动化邮件管理
  • 批量处理邮件
  • 邮件搜索和过滤
  • 邮件发送自动化

工具列表

  • list_emails: 列出邮件
  • search_emails: 搜索邮件
  • send_email: 发送邮件
  • modify_email: 修改邮件状态

常见问题解答

无明确常见问题解答部分

使用教程

使用依赖

  1. Node.js: 安装 Node.js 14 或更高版本
  2. Google Cloud Console 设置:
  3. 访问 Google Cloud Console
  4. 创建新项目或选择现有项目
  5. 启用 Gmail API
  6. 设置 OAuth 2.0 凭据

安装教程

  1. 克隆并安装: bash git clone https://github.com/yourusername/google-gmail-mcp-server.git cd google-gmail-mcp-server npm install

  2. 创建 OAuth 凭据: 创建 credentials.json 文件

  3. 获取刷新令牌: bash node get-refresh-token.js

  4. 配置 MCP 设置: 在 MCP 设置文件中添加服务器配置

  5. 构建并运行: bash npm run build

调试方式

无明确调试步骤说明

使用示例

Gmail 操作

  1. 列出最近邮件: json { "maxResults": 5, "query": "is:unread" }

  2. 搜索邮件: json { "query": "from:[email protected] has:attachment", "maxResults": 10 }

  3. 发送邮件: json { "to": "[email protected]", "subject": "Hello", "body": "Message content", "cc": "[email protected]", "bcc": "[email protected]" }

  4. 修改邮件: json { "id": "message_id", "addLabels": ["UNREAD"], "removeLabels": ["INBOX"] }

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。