AgentMail工具箱
为AI代理提供即时收件箱。代理/大型语言模型可以在隔离的收件箱中发送、接收和采取行动。专为人工智能打造，不同于Gmail。请访问agentmail.to了解我们。
可用工具 （10 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
listInboxes 2 个参数
List all inboxes
该工具无需必填参数，直接调用即可
getInbox 1 个参数 需填 1 项
Get inbox by ID
必填参数：inbox_id
createInbox 3 个参数
Create a new inbox
该工具无需必填参数，直接调用即可
listThreads 3 个参数 需填 1 项
List threads by inbox ID
必填参数：inbox_id
getThread 2 个参数 需填 2 项
Get thread by ID
必填参数：inbox_id、thread_id
listMessages 3 个参数 需填 1 项
List messages
必填参数：inbox_id
getMessage 2 个参数 需填 2 项
Get message by ID
必填参数：inbox_id、message_id
getAttachment 3 个参数 需填 3 项
Get attachment by ID
必填参数：inbox_id、message_id、attachment_id
sendMessage 7 个参数 需填 4 项
Send a message
必填参数：inbox_id、to、subject、text
replyToMessage 5 个参数 需填 3 项
Reply to a message
必填参数：inbox_id、message_id、text
服务介绍
AgentMail MCP 集成
一个简单的模型上下文协议 (MCP) 服务器，与 AgentMail 集成，通过 AI 助手（如 Claude）动态管理邮箱、列出邮件、发送或回复电子邮件。此参考实现演示了如何在 MCP 服务器中使用 AgentMail 的 API 来即时编排邮箱。
关于 AgentMail
AgentMail 是一个以 API 为先的电子邮件提供商，允许 AI 代理即时创建邮箱以发送、接收和处理电子邮件。我们在电子邮件层之上构建了多层智能，优化了代理工作流程，并使数据能够被大语言模型消化。请在此处请求 API 密钥 这里！
重要提示
这是一个正在进行中的包，因为 MCP 协议仍在不断发展中。一旦添加新功能，我们将立即更新。加入我们的 Discord 社区！Discord
特性
- 动态创建新邮箱
- 列出并检索邮箱 以查看哪些是活跃的
- 从您的任何 AgentMail 邮箱发送电子邮件
- 在现有线程中回复消息
- 列出所选邮箱的线程和消息
- 检索消息附件
前提条件
- Python 3.10+
- AgentMail API 密钥
- （可选）Claude Desktop 或支持 MCP 命令的任何其他前端
安装
该项目存在一个 PyPi 包。安装后，您可以在 Claude Desktop 配置中引用它（或直接运行），以启用电子邮件管理工具。
PIP（本地或 PyPI）
如果您维护自己的 Python 环境，只需从虚拟环境中安装该包（从 PyPI 或本地源）：
pip install agentmail-mcp
然后运行：
agentmail-mcp --api-key="YOUR_AGENTMAIL_API_KEY"
这将使服务器在您的本地机器上运行。
选项 1：使用 Claude Desktop
如果您想从 Claude Desktop 与服务器交互，请按照以下步骤操作。
- 激活您的虚拟环境。
source .venv/bin/activate
- 运行下面的命令以查找 Agentmail MCP 服务器包的位置。如果在虚拟环境中安装了 agentmail-mcp 包，它应该位于某个 .venv/bin/ 目录中。对于 Claude Desktop，重要的是您需要在虚拟环境中安装它。
which agentmail-mcp
-
复制返回的路径。
-
将路径粘贴到
claude_desktop_config.json文件中的command字段中。 -
重启 Claude Desktop。
以下是 claude_desktop_config.json 文件应具有的样子：
{
"mcpServers": {
"agentmail-mcp": {
"command": "/path/to/agentmail-mcp",
"args": ["--api-key", "{AGENT_MAIL_API_KEY}"]
}
}
}
如果您没有 claude_desktop_config.json 文件，请在以下目录中创建一个：
在 macOS 上，配置文件通常位于：~/Library/Application Support/Claude/claude_desktop_config.json
在 Windows 上，通常位于：%APPDATA%/Claude/claude_desktop_config.json
保存后，重启 Claude Desktop 以加载新的 MCP 服务器。
使用方法
在Claude Desktop（或其他MCP客户端）中运行您的服务器后，您可以使用自然语言命令来指示Claude执行与AgentMail MCP工具相对应的操作。例如：
- “创建一个名为demo的新收件箱。”
- “列出我所有的收件箱。”
- “从收件箱test@agentmail.to向test@example.com发送一封主题为‘Hello’的邮件，并在正文中解释过去一周旧金山的天气情况。”
- “回复收件箱abc123中的最新消息。”
内部实现上，Claude会调用暴露出来的MCP工具（如create_inbox, list_inboxes, send_message等），这些工具再进一步调用AgentMail API。
许可证
许可证
MIT许可证 - 本项目按照MIT许可证分发。使用风险自负。
⸻
