Agent skill
agentmail-cli
Send and receive emails programmatically using the AgentMail CLI. Use when agents need to manage inboxes, send/receive emails, handle threads, drafts, webhooks, and domains via command line.
Install this agent skill to your Project
npx add-skill https://github.com/agentmail-to/agentmail-skills/tree/main/agentmail-cli
SKILL.md
AgentMail CLI
Use the agentmail CLI to send and receive emails programmatically. Requires AGENTMAIL_API_KEY environment variable.
Install
npm install -g agentmail-cli
Core Commands
Inboxes
# Create an inbox
agentmail inboxes create --display-name "My Agent" --username myagent --domain example.com
# List inboxes
agentmail inboxes list
# Get an inbox
agentmail inboxes retrieve --inbox-id <inbox_id>
# Delete an inbox
agentmail inboxes delete --inbox-id <inbox_id>
Send Email
# Send a message from an inbox
agentmail inboxes:messages send --inbox-id <inbox_id> \
--to "recipient@example.com" \
--subject "Hello" \
--text "Message body"
# Send with HTML
agentmail inboxes:messages send --inbox-id <inbox_id> \
--to "recipient@example.com" \
--subject "Hello" \
--html "<h1>Hello</h1>"
# Reply to a message
agentmail inboxes:messages reply --inbox-id <inbox_id> --message-id <message_id> \
--text "Reply body"
# Forward a message
agentmail inboxes:messages forward --inbox-id <inbox_id> --message-id <message_id> \
--to "someone@example.com"
Read Email
# List messages in an inbox
agentmail inboxes:messages list --inbox-id <inbox_id>
# Get a specific message
agentmail inboxes:messages retrieve --inbox-id <inbox_id> --message-id <message_id>
# List threads
agentmail inboxes:threads list --inbox-id <inbox_id>
# Get a thread
agentmail inboxes:threads retrieve --inbox-id <inbox_id> --thread-id <thread_id>
Drafts
# Create a draft
agentmail inboxes:drafts create --inbox-id <inbox_id> \
--to "recipient@example.com" \
--subject "Draft" \
--text "Draft body"
# Send a draft
agentmail inboxes:drafts send --inbox-id <inbox_id> --draft-id <draft_id>
Pods
Pods group inboxes together.
# Create a pod
agentmail pods create --name "My Pod"
# Create an inbox in a pod
agentmail pods:inboxes create --pod-id <pod_id> --display-name "Pod Inbox"
# List threads in a pod
agentmail pods:threads list --pod-id <pod_id>
Webhooks
# Create a webhook for new messages
agentmail webhooks create --url "https://example.com/webhook" --event-type message.received
# List webhooks
agentmail webhooks list
Domains
# Add a custom domain
agentmail domains create --domain example.com --feedback-enabled false
# Verify domain DNS
agentmail domains verify --domain-id <domain_id>
# Get DNS records to configure
agentmail domains get-zone-file --domain-id <domain_id>
Global Flags
All commands support: --api-key, --base-url, --environment, --format, --debug.
Output Formats
Use --format to control output: json (default), pretty, yaml, jsonl, raw, explore.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agentmail-to/agentmail-skills
agentmail-mcp
AgentMail MCP server for email tools in AI assistants. Use when setting up AgentMail with Claude Desktop, Cursor, VS Code, Windsurf, or other MCP-compatible clients. Provides tools for inbox management, sending/receiving emails, and thread handling.
agentmail-to/agentmail-skills
agentmail-toolkit
Add email capabilities to AI agents using popular frameworks. Provides pre-built tools for TypeScript and Python frameworks including Vercel AI SDK, LangChain, Clawdbot, OpenAI Agents SDK, and LiveKit Agents. Use when integrating AgentMail with agent frameworks that need email send/receive tools.
agentmail-to/agentmail-skills
agentmail
Give AI agents their own email inboxes using the AgentMail API. Use when building email agents, sending/receiving emails programmatically, managing inboxes, handling attachments, organizing with labels, creating drafts for human approval, or setting up real-time notifications via webhooks/websockets. Supports multi-tenant isolation with pods.
mattpocock/skills
handoff
Compact the current conversation into a handoff document for another agent to pick up.
mattpocock/skills
setup-pre-commit
Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.
mattpocock/skills
obsidian-vault
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
Didn't find tool you were looking for?