/SKILL.md
Send and receive emails programmatically using the AgentMail API via CLI
npx skillsauth add agentmail-to/agentmail-cli agentmailInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use the agentmail CLI to send and receive emails programmatically. Requires AGENTMAIL_API_KEY environment variable.
npm install -g agentmail-cli
# 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 a message from an inbox
agentmail inboxes:messages send --inbox-id <inbox_id> \
--to "[email protected]" \
--subject "Hello" \
--text "Message body"
# Send with HTML
agentmail inboxes:messages send --inbox-id <inbox_id> \
--to "[email protected]" \
--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 "[email protected]"
# 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>
# Create a draft
agentmail inboxes:drafts create --inbox-id <inbox_id> \
--to "[email protected]" \
--subject "Draft" \
--text "Draft body"
# Send a draft
agentmail inboxes:drafts send --inbox-id <inbox_id> --draft-id <draft_id>
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>
# Create a webhook for new messages
agentmail webhooks create --url "https://example.com/webhook" --event-type message.received
# List webhooks
agentmail webhooks list
# 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>
All commands support: --api-key, --base-url, --environment, --format, --debug.
Use --format to control output: json (default), pretty, yaml, jsonl, raw, explore.
tools
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.