# agentmail-manage-inboxes

A skill that walks the agent through creating, listing, updating and deleting AgentMail inboxes over MCP. Useful when your agent needs its own address.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 425 installs · ★ 25
- Author: agentmail-to
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/agentmail-to/agentmail-skills/tree/HEAD/agentmail-manage-inboxes/SKILL.md
- Updated: 2026-10-06
- HTML: https://affpapa.org/en/nevibecode/skills/agentmail-manage-inboxes

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add agentmail-to/agentmail-skills --skill agentmail-manage-inboxes -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/agentmail-manage-inboxes/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/agentmail-manage-inboxes/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add agentmail-to/agentmail-skills --skill agentmail-manage-inboxes -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/agentmail-manage-inboxes/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add agentmail-to/agentmail-skills --skill agentmail-manage-inboxes -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/agentmail-manage-inboxes/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install agentmail-to/agentmail-skills agentmail-manage-inboxes
```

2. **Manually: put the files in place**
- File: `.github/skills/agentmail-manage-inboxes/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add agentmail-to/agentmail-skills --skill agentmail-manage-inboxes -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/agentmail-to/agentmail-skills --path agentmail-manage-inboxes
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/agentmail-manage-inboxes/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add agentmail-to/agentmail-skills --skill agentmail-manage-inboxes -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/agentmail-to/agentmail-skills/tree/HEAD/agentmail-manage-inboxes/SKILL.md

## When to use it
- 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
- List every AgentMail inbox with its ID
- Create a new inbox named `support` on the verified domain
- Delete inbox `inbox_123`, show its address first

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [agentmail-to/agentmail-skills](https://affpapa.org/en/nevibecode/by/agentmail-to/agentmail-skills.md) — 6 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md