A Claude Skill that teaches Claude how to build email agents using the AgentMail API.
A Claude Skill is a "skill pack" that helps Claude learn to use specific APIs/tools. The core is a SKILL.md file containing essential information, best practices, and code examples.
agentmail-claude-skill/
├── SKILL.md # Core skill file (~400 lines)
└── references/
├── api-reference.md # Complete API method signatures
├── webhook-events.md # Webhook event types and payloads
└── examples.md # Advanced agent patterns
- Quick start (installation, initialization, first email)
- Resource hierarchy (Organization → Pod → Inbox → Thread → Message)
- Common workflows (send, reply, webhooks, websockets)
- AI agent integration (agentmail-toolkit)
- Best practices (idempotency, deliverability)
- Critical gotchas
- All methods for: Inboxes, Messages, Threads, Webhooks, WebSockets, Domains, Pods, Drafts, API Keys, Metrics, Organizations
- Parameter types and return values
- Error types
- All 7 event types with full payload examples
message.received,message.sent,message.delivered,message.bounced,message.complained,message.rejected,domain.verified
- Event-driven agent (Flask + ngrok)
- WebSocket real-time agent
- Multi-step workflow with state
- Human-in-the-loop with drafts
- Label-based workflow
- Multi-tenant with pods
- Attachment processing
- TypeScript examples
Copy the skill to your Cursor skills directory:
cp -r agentmail-claude-skill ~/.cursor/skills/agentmailCopy to your project's .cursor/skills/ directory:
cp -r agentmail-claude-skill .cursor/skills/agentmailOnce installed, Claude will automatically use this skill when:
- Building email automation
- Creating AI email agents
- Setting up webhooks for email notifications
- Integrating email into AI workflows
- Working with AgentMail, inboxes, or email agents
MIT