Skip to main content
Get your AI agent its own email address in two commands.

​
Prerequisites

1

Install the skill

Inside Claude Code, run:
/plugin marketplace add openmailsh/skills
/plugin install openmail@openmailsh-skills
Claude Code now knows how to use OpenMail.
2

Run setup

In your terminal:
npx @openmail/cli setup --agent claude-code
This opens your browser to sign in, prompts for a mailbox name, creates your inbox, and writes credentials to ~/.claude/openmail.env.
3

Verify

npx @openmail/cli status
Your agent can now send and receive email. Ask Claude Code to send a test email to confirm.

​
More commands

openmail messages list --direction inbound
openmail threads list
openmail threads get --thread-id <thread-id>

​
Next steps

WebSockets

Real-time event streaming. No public URL needed.

Email deliverability

Warm-up schedules and content best practices.

Threading

How threads work across inbound and outbound.

API integration

Create inboxes programmatically for multi-tenant apps.