邮件代理mcp
MCP（模型上下文协议）服务器，通过以下方式为任何兼容MCP的AI代理提供完整的电子邮件功能 邮件代理.
安装
npm install -g mails-agent-mcp先决条件
您需要一个已配置的邮件代理邮箱(~/.mails/config.json):
npm install -g mails-agent
mails claim yourname # claims yourname@mails0.com配置Claude桌面
添加 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"mails-agent": {
"command": "mails-agent-mcp"
}
}
}配置光标
添加到光标MCP设置(.cursor/mcp.json):
{
"mcpServers": {
"mails-agent": {
"command": "mails-agent-mcp"
}
}
}工具
send_邮件
从您的邮箱发送电子邮件。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 收件人 | 字符串 | 是 | 收件人电子邮件地址 |
| 主题 | 字符串 | 是 | 电子邮件主题行 |
| body | string | yes | 纯文本电子邮件正文 |
| html | string | no | 可选html电子邮件正文 |
get_inbox
在您的邮箱中列出最近的电子邮件。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | number | no | 要返回的最大电子邮件数（默认值20） |
| query | string | no | 搜索查询以过滤电子邮件 |
| direction | string | no | “入站”或“出站” |
| label | string | no | 按标签筛选：时事通讯、通知、代码、个人 |
| mode | enum | no | 搜索模式：“关键字”（FTS5）、“语义”（向量）、“混合”（两者）。默认值：“关键字” |
搜索框
按关键字、语义相似性或混合搜索电子邮件。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | yes | 搜索查询关键字 |
| limit | number | no | 返回的最大结果数（默认值20） |
| label | string | no | 按标签筛选：时事通讯、通知、代码、个人 |
| mode | enum | no | 搜索模式：“关键字”（FTS5）、“语义”（向量）、“混合”（两者）。默认值：“关键字” |
get_email
通过ID获取特定电子邮件的完整详细信息。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | yes | 电子邮件id |
等待代码
等待验证码电子邮件到达。轮询，直到收到代码或达到超时。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| timeout | number | no | 最长等待秒数（默认30） |
| since | string | no | 仅返回此ISO时间戳之后收到的代码（例如2026-03-27T10:00:00Z） |
删除电子邮件
按ID删除电子邮件。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | yes | 要删除的电子邮件id |
获取附件
按ID下载附件。对于基于文本的文件，返回内联文本内容，对于二进制文件，返回元数据。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | yes | 附件id |
get_threads
列出邮箱中的电子邮件主题。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | number | no | 要返回的最大线程数（默认值20） |
get_thread
获取特定线程中的所有电子邮件。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | yes | 线程id |
提取数据
从电子邮件中提取结构化数据（订单、发货、日历、收据、代码）。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| email_id | string | yes | 要从中提取数据的电子邮件id |
| type | enum | yes | 数据类型：订单、发货、日历、收据、代码 |
运作原理
MCP服务器从以下位置读取您的邮件代理配置 ~/.mails/config.json 并对mail-agent Worker API进行经过验证的API调用。它支持两种托管模式(api_key 和 /v1/* 端点）和自托管模式(worker_token 和 /api/* 端点）。
生态系统
| 项目 | 描述 |
|---|---|
| 邮件 | 电子邮件服务器（Worker）+CLI+TypeScript SDK |
| 邮件代理mcp （此仓库） | 用于AI代理的MCP服务器 |
| 邮件代理（Python） | Python SDK |
| 邮件技巧 | AI代理的技能档案 |
许可证
麻省理工学院