agentmail-cli

Use the agentmail CLI to send and receive emails programmatically. Requires AGENTMAIL_API_KEY environment variable.

agentmail-to/agentmail-skills|Updated Apr 30, 2026

Works with

Claude CodeCursorClineWindsurfCodexGoose

Installation Guide

Select your AI agent

How to use agentmail-cli on Cursor

AI-first code editor with Composer

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

›Cursor installed and configured on your machine
›Node.js 16+ with npm — verify with node --version
›Active project directory where you want to add agentmail-cli

Run the install command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/agentmail-to/agentmail-skills --skill agentmail-cli

Fetches agentmail-cli from agentmail-to/agentmail-skills and configures it for Cursor.

Select Cursor when prompted

The CLI shows a list of agents. Use arrow keys and space to select Cursor:

◆ Which agents do you want to install to?

│

│ ── Universal (.agents/skills) ────────────────

│ · Cline · Codex · Goose · Windsurf

│ ●Cursor(selected)

│ · Cursor · Aider · Continue

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/agentmail-cli

Restart Cursor to activate agentmail-cli. Access via /agentmail-cli in your agent's command palette.

⚠

Security Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.

›View source on GitHub ›Skills CLI docs ›About Cursor ›What are agent skills?

Documentation

List & Monetize Your Skill

Submit your Claude Code skill and start earning

Get started →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

✓

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

✓

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

✓

Improve work quality by 30-40% with less effort

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 "[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]"

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 "[email protected]" \ --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>

agentmail-cli

Installation Guide

How to use agentmail-cli on Cursor

Prerequisites

Run the install command

Select Cursor when prompted

Verify installation

Security Notice

Documentation

List & Monetize Your Skill

Use Cases

Task Automation & Efficiency

Knowledge Enhancement

Quality Improvement

Install Skill

AgentMail CLI

Install

Core Commands

Inboxes

Send Email

Read Email

Drafts

Pods

Webhooks

Domains

Global Flags

Output Formats

Implementation Guide

Best Practices

When to Use This

Learning Path

Related Skills

notion-cli

colab-session-operator

ml-paper-writing

beautiful-mermaid

llm-council

blockchain-developer

Reviews

Discussion