Agent Email
Send and receive email from your agent's dedicated email address
Agent Email
Every Agnic agent gets a dedicated email address (agent-{id}@agent.agnic.ai) for sending emails, receiving replies, and signing up for services.
Commands
Check Email Address
Set Up Email Alias
| Option | Description |
|---|---|
--display-name <name> | Display name for outgoing emails |
--json | Output as JSON |
Check Inbox
| Option | Description |
|---|---|
--limit <n> | Max messages to show (default: 20, max: 100) |
--json | Output as JSON |
Send Email
| Option | Description |
|---|---|
--to <address> | Recipient email address (required) |
--subject <subject> | Email subject line (required) |
--body <body> | Email body text (required) |
--json | Output as JSON |
Reply to Message
| Option | Description |
|---|---|
--message-id <id> | ID of the message to reply to (required) |
--body <body> | Reply body text (required) |
--json | Output as JSON |
Examples
How It Works
- Auto-created on onboarding — when your agent is registered, an email alias is created automatically
- Unique address — each agent gets
agent-{id}@agent.agnic.ai - Full inbox — inbound emails are stored and accessible via CLI, MCP, or API
- 30-day retention — messages older than 30 days are automatically cleaned up
Prerequisites
- Must be authenticated (
npx agnic@latest auth login) - Agent must be onboarded (happens automatically on first API key creation)
Error Handling
| Error | Solution |
|---|---|
| "Not authenticated" | Run npx agnic@latest auth login |
| "No email alias found" | Run npx agnic@latest email setup |
| "No active agent found" | Complete onboarding at pay.agnic.ai |
| "Email sending not configured" | Contact support — Resend provider may be unavailable |