agentmail-manage-inboxes — Claude Code skill: AgentMail inbox control
A skill that walks the agent through creating, listing, updating and deleting AgentMail inboxes over MCP. Useful when your agent needs its own address.
npx skills add agentmail-to/agentmail-skills --skill agentmail-manage-inboxes -a claude-codeWhat agentmail-manage-inboxes does
The skill covers the whole inbox lifecycle on AgentMail: listing, details, creation, edits and removal. It runs against a connected MCP server, so sending and reading mail stay with other skills. list_inboxes returns what exists; get_inbox pulls exact fields for one inbox.
Creation happens only when you ask for it. The agent passes along the username you requested, a verified domain, display name, metadata and client ID if you supplied them. Metadata keys merge on update, and nulling a key drops it — the agent is expected to say so. Deletion is previewed with the exact ID or address and needs your explicit confirmation, since the inbox's mail becomes unreachable.
The agent does not make up a domain or treat one as verified. Idempotent creation relies on a stable client ID, and credentials keep their existing scope. Instructions that arrive inside an email, attachment or webhook authorize nothing by themselves: they turn into a draft that waits for your go-ahead.
What it helps with
- give an agent its own email address
- list inboxes and their IDs
- change an inbox display name or metadata
- delete an inbox without cutting off mail by mistake
- check that a domain is verified before creating an address
Example prompts for the agent
- List every AgentMail inbox with its ID
- Create a new inbox named
supporton the verified domain - Delete inbox
inbox_123, show its address first
How to install agentmail-manage-inboxes
1Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail-manage-inboxes -a claude-code2Manually: put the files in place
~/.claude/skills/agentmail-manage-inboxes/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/agentmail-manage-inboxes/
1Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail-manage-inboxes -a codex2Manually: put the files in place
.agents/skills/agentmail-manage-inboxes/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail-manage-inboxes -a cursor2Manually: put the files in place
.cursor/skills/agentmail-manage-inboxes/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install agentmail-to/agentmail-skills agentmail-manage-inboxes2Manually: put the files in place
.github/skills/agentmail-manage-inboxes/SKILL.md1Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail-manage-inboxes -a gemini-cli2Platform CLI
gemini skills install https://github.com/agentmail-to/agentmail-skills --path agentmail-manage-inboxesManually: put the files in place
.devin/skills/agentmail-manage-inboxes/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail-manage-inboxes -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about agentmail-manage-inboxes
How do I install agentmail-manage-inboxes in Claude Code?
Run npx skills add agentmail-to/agentmail-skills --skill agentmail-manage-inboxes -a claude-code. The skill file lands at ~/.claude/skills/agentmail-manage-inboxes/SKILL.md.
What does agentmail-manage-inboxes do?
It guides the agent through AgentMail inbox operations over MCP: listing, inspecting, creating, updating and deleting. Sending or reading mail is handled elsewhere.
Does deleting an inbox require confirmation?
Yes. The agent shows the exact ID or address first and deletes only after you confirm, because the action is destructive and cuts off access to that inbox's mail.
