# agentmail

Teaches your agent to write code against the AgentMail TypeScript or Python SDK: inboxes, messages, webhooks, domains.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2900 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/SKILL.md
- Updated: 2026-10-06
- HTML: https://affpapa.org/en/nevibecode/skills/agentmail

## What it does

AgentMail is an email API built for AI agents. This skill gives the coding agent a short map of the SDK so it stops inventing method names. Inside are starting examples for TypeScript and Python, calling conventions, and a list of API traps worth reading before writing code.

An agent working with it can create an inbox, send mail, pull the reply, set up webhooks, manage domains. Deeper references cover Svix signature checks, WebSocket events, allow and block lists, and triage for mail that never arrived. Credentials live in `AGENTMAIL_API_KEY`.

Watch the sign-up call. Running `sign_up` again with the same `human_email` rotates the API key and kills the old one instantly, so it must never run inside a retry loop or a key check. Also: the attachment method hands back a signed URL on `cdn.agentmail.to` that expires in about an hour, not the file bytes. The skill is scoped to SDK code work — direct mailbox operations, CLI use and MCP setup sit outside it. You need the `agentmail` package, from `npm install agentmail` or `pip install agentmail`.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add agentmail-to/agentmail-skills --skill agentmail -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/SKILL.md

## When to use it
- create an agent inbox programmatically
- send a message and read the reply without quoted history
- set up a sending domain with DNS records
- verify Svix signatures on incoming webhooks
- trace why an agent's email never arrived

## Example prompts
- Write Python code that creates an inbox named `support` and sends a message with the agentmail SDK
- Port this script to the TypeScript agentmail SDK and fix the message-delete error
- Go through the agentmail skill and tell me why my agent's email is bouncing

## 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