agentmail
Email infrastructure for AI agents. Create accounts, send/receive emails, manage webhooks, and check karma balance via the AgentMail API.
Profile →npx skills add sickn33/agentic-awesome-skills --skill agentmail --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# AgentMail — Email for AI Agents AgentMail gives AI agents real email addresses (`@theagentmail.net`) with a REST API. Agents can send and receive email, sign up for services (GitHub, AWS, Slack, etc.), and get verification codes. A karma system prevents spam and keeps the shared domain's reputation high. Base URL: `https://api.theagentmail.net` ## When to Use - An AI agent needs a real inbox/outbox for signups, verification flows, or transactional communication. - You need to provision AgentMail accounts, send messages, read inbox contents, or register inbound webhooks. - You need to monitor karma usage or wire email events into agent automation. ## Quick start All requests require `Authorization: Bearer am_...` header (API key from dashboard). ### Create an email account (-10 karma) ```bash curl -X POST https://api.theagentmail.net/v1/accounts \ -H "Authorization: Bearer am_..." \ -H "Content-Type: application/json" \ -d '{"address": "my-agent@theagentmail.net"}' ``` Response: `{"data": {"id": "...", "address": "my-agent@theagentmail.net", "displayName": null, "createdAt": 123}}` ### Send email (-1 karma) ```bash curl -X POST https://api.theagentmail.net/v1/accounts/{accountId}/
- When to Use
- Quick start
- Create an email account (-10 karma)
- Send email (-1 karma)
- Read inbox
- Check karma
- Register webhook (real-time inbound)
- Download attachment
- Full API reference
- Karma system
- TypeScript SDK
- Error handling
- Common patterns
- Sign up for a service and read verification email
curl -X POST https://api.theagentmail.net/v1/accounts \
curl -X POST https://api.theagentmail.net/v1/accounts/{accountId}/messages \
List messages
curl https://api.theagentmail.net/v1/accounts/{accountId}/messages \
Get full message (with body and attachments)
curl https://api.theagentmail.net/v1/accounts/{accountId}/messages/{messageId} \
curl https://api.theagentmail.net/v1/karma \
curl -X POST https://api.theagentmail.net/v1/accounts/{accountId}/webhooks \
curl https://api.theagentmail.net/v1/accounts/{accountId}/messages/{messageId}/attachments/{attachmentId} \What does the agentmail skill do?
Email infrastructure for AI agents. Create accounts, send/receive emails, manage webhooks, and check karma balance via the AgentMail API.
How do I install it?
Run `npx skills add sickn33/agentic-awesome-skills --skill agentmail --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.