AI导哈

Gmail邮件发送服务

一个通过Gmail SMTP发送邮件的MCP服务器，为Claude提供电子邮件发送功能。

  • by primeBeri
  • C#
  • 本地部署
  • 更新于
在 GitHub 查看 Shade666/gmail-send-mcp

使用说明

GmailSend MCP

用于通过Gmail SMTP发送电子邮件的最小MCP（模型上下文协议）服务器。暴露单个 send_email 工具通过stdio传输到Claude。

先决条件

1.净10 SDK

从以下位置安装 dot.net.

2.Gmail应用程序密码

需要启用两步验证的Google帐户。

  1. 首选 myaccount.google.com/apppasswords
  2. 创建一个新的应用程序密码——将其标记为 claude-mcp
  3. 复制16个字符的密码（格式： xxxx xxxx xxxx xxxx)

设置

环境变量

服务器在启动时从环境变量中读取凭据，如果缺少凭据，将拒绝启动。

变量 示例值
GMAIL_ADDRESS you@gmail.com
GMAIL_APP_PASSWORD abcd efgh ijkl mnop

项目MCP配置（克劳德代码）

A. .mcp.json 从该项目目录运行Claude Code时使用该文件。它被git忽略，因为它包含凭据。

复制模板并填写您的凭据：

cp .mcp.json.example .mcp.json   # if you create one, or edit .mcp.json directly

编辑 .mcp.json:

{
  "mcpServers": {
    "gmail": {
      "command": "dotnet",
      "args": ["run", "--project", "gmail-mcp"],
      "env": {
        "GMAIL_ADDRESS": "you@gmail.com",
        "GMAIL_APP_PASSWORD": "abcd efgh ijkl mnop"
      }
    }
  }
}

Claude桌面配置

添加 %APPDATA%\Claude\claude_desktop_config.json （Windows）或 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）：

{
  "mcpServers": {
    "gmail": {
      "command": "dotnet",
      "args": ["run", "--project", "C:/path/to/GmailSend-mcp/gmail-mcp"],
      "env": {
        "GMAIL_ADDRESS": "you@gmail.com",
        "GMAIL_APP_PASSWORD": "abcd efgh ijkl mnop"
      }
    }
  }
}

为了更快地启动，请更换 dotnet run --project gmail-mcp 运行后编译的二进制文件的路径 dotnet publish.

用法

一旦注册，克劳德将有权访问 send_email 工具。

工具： send_email

参数 类型 必填 说明
to string yes 收件人地址，逗号分隔
subject string yes 电子邮件主题行
body string yes 电子邮件正文内容
cc string no 抄送收件人，逗号分隔
bcc string no 密件抄送收件人，逗号分隔
is_html bool no 以HTML格式发送正文（默认值：false）

示例提示

Send an email to alice@example.com with subject "Meeting notes" and a summary of our conversation.

Draft and send a HTML-formatted status update to the team at team@example.com.

Email bob@example.com and cc carol@example.com to let them know the deploy succeeded.

能力

  • 通过Gmail SMTP发送纯文本或HTML电子邮件
  • 收件人、抄送和密件抄送上有多个收件人（逗号分隔）
  • 仅来自环境变量的凭据——代码中没有存储任何凭据

局限性

  • 仅限Gmail --硬编码为 smtp.gmail.com:587 与STARTTLS
  • 需要应用程序密码 --不支持OAuth2
  • 无附件
  • 无已发送邮件跟踪 --该工具返回成功/失败字符串，但不验证交付
  • Gmail发送限制 --Gmail强制普通账户每天发送500封电子邮件
  • dotnet run 启动延迟 --每次Claude会话都会通过以下方式冷启动服务器 dotnet run。使用已发布的二进制文件来减少此问题

发展

# Build
dotnet build

# Run tests
dotnet test

# Run a single test class
dotnet test --filter "FullyQualifiedName~EmailService"

# Run the server manually (requires env vars)
$env:GMAIL_ADDRESS="you@gmail.com"
$env:GMAIL_APP_PASSWORD="xxxx xxxx xxxx xxxx"
dotnet run --project gmail-mcp

项目结构

gmail-mcp/
├── Program.cs        — DI wiring, env var validation, MCP stdio server
├── EmailService.cs   — IEmailService interface + MailKit SMTP implementation
└── SendEmailTool.cs  — MCP tool definition ([McpServerTool] attribute)
gmail-mcp.Tests/
├── EmailServiceTests.cs   — Unit tests for credential validation and message construction
└── SendEmailToolTests.cs  — Unit tests for tool parameter validation and send behaviour

相关 MCP