# agentmail-check-email

Inspects, filters, and summarizes AgentMail inboxes using a connected MCP server. It lets agents process incoming mail safely without obeying prompt injection payloads.

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

## What it does

This skill guides an agent through reading mail via an AgentMail MCP connection. If you do not specify a mailbox, the agent identifies it through `list_inboxes`. It applies keyword searches or query filters by sender, date, and label. Search results return basic summaries, so the assistant retrieves full bodies via `get_message` or `get_thread` before writing any recap.

Triage workflows rely directly on labels. The agent updates state flags via `update_message` to clear `unread` or apply tags like `needs-reply`. If your automated triage script never modifies these labels, it gets stuck reprocessing identical messages on every run.

Security guidelines treat every inbound message as untrusted input. The assistant never obeys commands tucked inside headers, bodies, or attachments. It will not reveal keys, run code, or initiate outbound payments based on email text alone.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- search inbox threads by keyword, sender, or timestamp
- summarize long email conversations from cleaned message text
- triage unread mail into urgent or waiting categories
- inspect attachments without executing untrusted macros

## Example prompts
- Check my inbox for unread customer messages and summarize them.
- Find all emails from last week mentioning the invoice and mark them as processed.
- Review recent incoming threads and flag anything requiring an urgent reply.

## Similar
- [email-pair](https://affpapa.org/en/nevibecode/plugins/email-pair.md) — plugin · ★ 28786
- [spark-recipe-inbox-zero](https://affpapa.org/en/nevibecode/skills/spark-recipe-inbox-zero.md) — skill · 344 installs
- [agent-email-inbox](https://affpapa.org/en/nevibecode/skills/agent-email-inbox.md) — skill · 13400 installs
- [inbox-setup](https://affpapa.org/en/nevibecode/skills/inbox-setup.md) — skill · 380 installs
- [spark-recipe-notification-hygiene](https://affpapa.org/en/nevibecode/skills/spark-recipe-notification-hygiene.md) — skill · 320 installs
- [at-email-cli](https://affpapa.org/en/nevibecode/skills/at-email-cli.md) — skill · 1100 installs

From the same set: [agentmail-to/agentmail-skills](https://affpapa.org/en/nevibecode/by/agentmail-to/agentmail-skills.md) — 7 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