agentmail-cli

Name: agentmail-cli
Author: Melvynx

Give AI agents their own email inboxes. Create inboxes, send/receive/reply to emails, manage threads, drafts, webhooks, domains, and multi-tenant pods via the AgentMail API. Use when: user wants to send email from an agent, create agent email addresses, manage agent email workflows, set up email webhooks, or anything involving agentmail.to.

social email dns ai

Install

$ npx api2cli install Melvynx/agentmail-cli

Details

Skill type: Wrapper CLI

Auth type: api-key

Version: 1.0.0

Author: Melvynx

Repo: https://github.com/Melvynx/agentmail-cli

README

agentmail-cli

CLI for the agentmail API. Made with api2cli.dev.

Install

npx api2cli install Melvynx/agentmail-cli

This clones the repo, builds the CLI, links it to your PATH, and installs the AgentSkill to your coding agents.

Install AgentSkill only

npx skills add Melvynx/agentmail-cli

Auth

Set your API token before using any commands:

agentmail-cli auth set "your-token"
agentmail-cli auth test
agentmail-cli auth show         # masked
agentmail-cli auth show --raw   # full token
agentmail-cli auth remove

Global Flags

All commands support:

Flag	Description
`--json`	Output as JSON
`--format <fmt>`	Output format: `text`, `json`, `csv`, `yaml`
`--verbose`	Enable debug logging
`--no-color`	Disable colored output
`--no-header`	Omit table/csv headers (for piping)

Resources

inboxes

agentmail-cli inboxes list [--limit <n>] [--page-token <token>] [--ascending]
agentmail-cli inboxes get <inbox-id>
agentmail-cli inboxes create [--username <username>] [--domain <domain>] [--display-name <name>] [--client-id <id>]

Examples:

agentmail-cli inboxes create --username agent1 --display-name 'My Agent'
agentmail-cli inboxes list --limit 10 --json
agentmail-cli inboxes get inbox_abc123

messages

agentmail-cli messages list <inbox-id> [--limit <n>] [--page-token <token>] [--labels <labels>] [--before <date>] [--after <date>] [--include-spam]
agentmail-cli messages get <inbox-id> <message-id>
agentmail-cli messages send <inbox-id> --to <addresses> [--cc <addresses>] [--bcc <addresses>] [--subject <subject>] [--text <body>] [--html <body>] [--reply-to <address>] [--labels <labels>]
agentmail-cli messages reply <inbox-id> <message-id> [--text <body>] [--html <body>] [--cc <addresses>] [--bcc <addresses>]

Examples:

agentmail-cli messages list inbox_abc123 --labels inbox --limit 10
agentmail-cli messages send inbox_abc123 --to user@example.com --subject 'Hello' --text 'Hi!'
agentmail-cli messages reply inbox_abc123 msg_xyz --text 'Thanks!'

threads

agentmail-cli threads list <inbox-id> [--limit <n>] [--page-token <token>] [--ascending]
agentmail-cli threads get <inbox-id> <thread-id>

Examples:

agentmail-cli threads list inbox_abc123 --limit 10
agentmail-cli threads get inbox_abc123 thread_xyz --json

webhooks

agentmail-cli webhooks list
agentmail-cli webhooks create --url <url> [--events <events>]

Available events: message.received, message.sent, message.delivered, message.bounced, message.complained, message.rejected, domain.verified

Examples:

agentmail-cli webhooks create --url https://myapp.com/webhook
agentmail-cli webhooks create --url https://myapp.com/webhook --events message.received,message.sent

pods

agentmail-cli pods list
agentmail-cli pods create --name <name> [--client-id <id>]

Examples:

agentmail-cli pods create --name 'My Pod'
agentmail-cli pods create --name 'My Pod' --client-id client1 --json

api-keys

agentmail-cli api-keys list
agentmail-cli api-keys create --name <name>

Examples:

agentmail-cli api-keys create --name 'My Key'
agentmail-cli api-keys list --json