AgentMail MCP 服务器用于把 AgentMail 的邮件能力接入任意兼容 MCP 的 AI 客户端，需先从 console.agentmail.to 获取 API 密钥。
接入方式有三种：一是远程托管，无需安装，在客户端配置中填写 URL https://mcp.agentmail.to 并设置环境变量 AGENTMAIL_API_KEY；二是本地 npm 包，通过 npx -y agentmail-mcp 运行；三是本地 Python 包，执行 pip install agentmail-mcp 安装后运行。可用 --tools 参数只加载指定工具，例如 send_message,reply_to_message,list_inboxes。
Claude Desktop 的配置位于 macOS 的 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 的 %APPDATA%/Claude/claude_desktop_config.json；Cursor、VS Code、Windsurf 分别使用 .cursor/mcp.json、.vscode/mcp.json 及各自的 MCP 配置文件。也可独立运行：export AGENTMAIL_API_KEY=your-api-key 后执行 agentmail-mcp。
提供的工具包括 create_inbox、list_inboxes、get_inbox、delete_inbox、send_message、reply_to_message、list_threads、get_thread、get_attachment、update_message，覆盖收件箱管理、收发邮件、线程查看、附件下载和标签更新。配置后可用自然语言让助手创建收件箱、发信、查收新邮件、回复、列出线程或下载附件。
兼容客户端包括 Claude Desktop、Cursor、VS Code、Windsurf、Cline、Goose、Raycast、ChatGPT、Amazon Q、Codex、Gemini CLI、LibreChat、Roo Code 等。常见问题：命令未找到时确认 npm/npx 在 PATH 中或使用完整路径；API 密钥无效时检查密钥与权限；Python 包未找到时在虚拟环境中用 which agentmail-mcp 获取完整可执行路径。