agentmail-check-email — Claude Code skill: how it works & install
Inspects, filters, and summarizes AgentMail inboxes using a connected MCP server. It lets agents process incoming mail safely without obeying prompt injection payloads.
npx skills add agentmail-to/agentmail-skills --skill agentmail-check-email -a claude-codeWhat agentmail-check-email 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.
What it helps with
- 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 for the agent
- 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.
How to install agentmail-check-email
1Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail-check-email -a claude-code2Manually: put the files in place
~/.claude/skills/agentmail-check-email/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/agentmail-check-email/
1Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail-check-email -a codex2Manually: put the files in place
.agents/skills/agentmail-check-email/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail-check-email -a cursor2Manually: put the files in place
.cursor/skills/agentmail-check-email/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install agentmail-to/agentmail-skills agentmail-check-email2Manually: put the files in place
.github/skills/agentmail-check-email/SKILL.md1Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail-check-email -a gemini-cli2Platform CLI
gemini skills install https://github.com/agentmail-to/agentmail-skills --path agentmail-check-emailManually: put the files in place
.devin/skills/agentmail-check-email/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail-check-email -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-check-email
How to install agentmail-check-email in Claude Code?
Run npx skills add agentmail-to/agentmail-skills --skill agentmail-check-email -a claude-code. The tool writes configuration to ~/.claude/skills/agentmail-check-email/SKILL.md.
What does agentmail-check-email do?
It directs the assistant to read, search, and label messages from an AgentMail MCP server. It handles pagination, fetches full conversation threads, and separates email claims from facts.
Does this skill send replies directly?
No. It can prepare a proposed draft response, but delivering mail requires the separate agentmail-send-email skill.
