Gmail

Search and delete emails in your Gmail account.

View on GitHub →

Gmail MCP Server

一个基于Model Context Protocol (MCP)的服务器，提供Gmail邮件删除功能。

功能

  • 通过MCP协议暴露Gmail邮件删除工具
  • 支持通过邮件ID删除指定用户的邮件
  • 提供邮件搜索功能，支持按条件查询邮件
  • 支持批量删除指定用户的多个邮件

环境要求

  • Java 17或更高版本
  • Maven 3.6+或Gradle 7.0+
  • Gmail API credentials.json文件

快速开始

1. 准备Gmail API凭据

  1. 前往Google Cloud Console
  2. 创建新项目并启用Gmail API
  3. 创建OAuth 2.0客户端ID凭据
  4. 下载credentials.json文件并保存到src/main/resources/目录

2. 构建项目

./mvnw clean install

3. 运行服务器

./mvnw spring-boot:run

配置

配置文件位于src/main/resources/application.properties，可修改以下参数：

  • server.port: 服务器端口，默认8080
  • spring.ai.mcp.server.enabled: 是否启用MCP服务器，默认true
  • gmail.credentials.path: Gmail凭据文件路径，默认classpath:credentials.json

使用方法

通过MCP客户端连接服务器后，可调用以下工具：

  • deleteEmail: 删除指定ID的邮件
    • 参数: userId(用户邮箱), messageId(邮件ID)
  • searchEmails: 搜索符合条件的邮件
    • 参数: userId(用户邮箱), query(搜索条件), maxResults(最大结果数)
    • 返回值: 邮件列表，包含邮件ID和基本信息
  • batchDeleteEmails: 批量删除邮件
    • 参数: userId(用户邮箱), messageIds(邮件ID列表)
    • 返回值: 操作结果状态

MCP server 配置

{
  "mcpServers": {
    "gmail-mcp-server": {
    "command": "java",
    "args": [
      "-Dspring.ai.mcp.server.stdio=true",
      "-Dspring.main.web-application-type=none",
      "-Dlogging.pattern.console=",
      "-jar",
      "/Users/arthur/.m2/repository/arthur/mcp/gmail-mcp-server/0.0.1-SNAPSHOT/gmail-mcp-server-0.0.1-SNAPSHOT.jar"
    ]
    }
  }
}

Related Servers