AGENT SKILL
agentmail
Use when an agent needs AgentMail CLI email inboxes.
- License 许可
- MIT
- 最近更新
- 2026-10-09
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- agentmail
- author
- Haakam Aujla (Haakam21), AgentMail
- license
- MIT
- version
- 1.0.0
- metadata
- { "mercury": { "tags": [ "Email", "CLI", "AgentMail", "Communication" ], "homepage": "https://agentmail.to" } }
- platforms
- [ "linux", "macos", "windows" ]
- description
- Use when an agent needs AgentMail CLI email inboxes.
- prerequisites
- { "commands": [ "agentmail" ] }
- required_environment_variables
- [ { "help": "Create one at https://console.agentmail.to — or run the CLI self-signup flow in references/signup.md to obtain a key without one.", "name": "AGENTMAIL_API_KEY", "prompt": "AgentMail API key (starts with am_)", "optional": true, "required_for": "authenticating the agentmail CLI; not needed before self-signup" } ]
02 资源文件 5
- 参考文档references/core.md2.9 KB
- 参考文档references/mcp.md313 B
- 参考文档references/signup.md1.1 KB
- 参考文档references/webhooks.md851 B
- 参考文档references/websockets.md1.3 KB
03 SKILL.md 正文
AgentMail Skill
AgentMail gives an agent its own email inbox for sending mail, receiving replies, completing email OTP flows, and running inbound email loops. Use it for agent-owned inboxes, not a user's existing IMAP/SMTP mailbox.
Use the agentmail CLI first. Use MCP only when the harness expects MCP tools;
use REST only when the CLI is missing a required operation.
When to Use
- The agent needs an email address it owns.
- The task involves email OTP flows, replies, threads, labels, or attachments.
- The agent needs webhook or WebSocket delivery for inbound mail.
Prerequisites
- Run commands through the
terminaltool. - Install the CLI:
npm install -g agentmail-cli@latest
- Export an API key:
export AGENTMAIL_API_KEY="am_..."
No API key yet? Use signup.md.
How to Run
Use --format json whenever another command or script needs IDs.
agentmail inboxes list --format json
Quick Reference
- AgentMail agent reference: hosted copy.
- AgentMail: product landing page.
- Console: API keys and account management.
- Docs: full product documentation.
- signup.md: self-signup and OTP verification.
- core.md: inboxes, messages, threads, labels, attachments.
- webhooks.md: events to a public HTTPS server.
- websockets.md: events to a local agent process.
- mcp.md: MCP integration.
Procedure
- Install
agentmail-cli@latestand verifyagentmail inboxes list --format json. - If no API key is available, complete signup.md.
- Use core.md for inbox, send, read, reply, forward, label, thread, and attachment flows.
- Add webhooks.md or websockets.md only when polling is not enough.
Pitfalls
- Prefer
AGENTMAIL_API_KEYover--api-key. - Never expose
AGENTMAIL_API_KEYin prompts, logs, URLs, or committed files. - Use stable
client_idvalues for retried create operations. - Prefer
extracted_textorextracted_htmlfor LLM input when present. - React to
message.received, not messages the agent sent.
Verification
agentmail inboxes list --format json
04 同仓库更多 Skills
greet
A greeting skill for testing
★ 0
valid-skill
A valid skill for testing purposes.
★ 0
unknown-field
A skill with an unknown frontmatter field.
★ 0
no-frontmatter
暂无简介
★ 0
child-skill
A nested skill in a subdirectory.
★ 0
different-name
A skill with a name that doesn't match the directory.
★ 0