Gmail MCP Server

Gmail MCP 服务

一个用于集成 Gmail 的模型上下文协议（MCP）服务，使用 FastMCP 构建。该服务通过一组标准化工具，为 AI 助手提供与 Gmail 交互的能力。

概览

本项目实现了一个 MCP 服务，允许 AI 助手执行各种 Gmail 操作，包括：

• 从收件箱获取邮件
• 按主题搜索邮件
• 搜索特定发件人发送的邮件
• 获取未读邮件
• 向收件人发送邮件

该服务使用 IMAP 获取邮件，使用 SMTP 发送邮件，所有操作均通过 Gmail 的身份验证系统进行保护。

设置

1. 克隆仓库

git clone https://github.com/shubhiscoding/Gmail-MCP-Server
cd gmail-mcp

2. 安装依赖项

npm install

3. 在根目录中创建 .env 文件，并添加以下变量：

GMAIL_USER=your_gmail_address
GMAIL_APP_PASSWORD=your-app-password

如需为 Gmail 账号生成应用专用密码：

1. 前往 Google 账号 > 安全性
2. 如果尚未启用两步验证，请先启用
3. 前往应用专用密码
4. 选择“邮件”和你的设备
5. 点击“生成”

使用方法

启动服务

以开发模式启动服务：

npm run dev

配置 Windsurf 运行

配置 mcp_config.json 以添加 gmail-mcp 服务：

{
  "mcpServers": {
    "gmail-mcp": {
      "command": "bash",
      "args": [
        "-c",
        "cd ~Your-Path-To-The-Repo/Gmail-MCP-Server && npm run start"
      ],
      "disabled": false
    }
  }
}

配置 Claude desktop 在 Windows 上运行

{
  "mcpServers": {
    "gmail-mcp": {
      "command": "cmd",
      "args": ["/c", "cd /d ~Your-Path-To-The-Repo\\Gmail-MCP-Server && npm run start"]
    }
  }
}

视频演示

Windsruf 演示

https://github.com/user-attachments/assets/0c45ec24-be45-4271-b7d0-fc6cd58b850f

Claude Desktop 演示

https://github.com/user-attachments/assets/ad1650e8-bcc4-481e-ab95-eaefd8de7472

可用工具

该服务为 AI 助手提供以下工具：

1. fetchEmails

从收件箱获取邮件，可选择应用筛选条件。

参数：

• limit（可选）：获取邮件的最大数量（默认值：10）
• mailbox（可选）：获取邮件的邮箱（默认值：'INBOX'）
• searchCriteria（可选）：IMAP 搜索条件（默认值：['ALL']）

2. fetchEmailsBySubject

获取主题特定的邮件。

参数：

• subject：要搜索的主题
• limit（可选）：获取邮件的最大数量（默认值：10）

3. fetchEmailsFromSender

获取特定发件人发送的邮件。

参数：

• sender：发件人的电子邮件地址
• limit（可选）：获取邮件的最大数量（默认值：10）

4. fetchUnreadEmails

从收件箱获取未读邮件。

参数：

• limit（可选）：获取邮件的最大数量（默认值：10）

5. sendEmails

向指定收件人发送邮件。

参数：

• to：收件人的电子邮件地址
• subject：邮件主题
• body：邮件正文

安全性

该服务使用环境变量存储 Gmail 凭据等敏感信息。切勿将 .env 文件提交到版本控制系统。

技术详情

本项目使用以下技术构建：

• TypeScript，用于类型安全
• Node.js IMAP 和 Nodemailer 库，用于邮件操作
• FastMCP，用于实现 MCP 服务
• dotenv，用于管理环境变量