AI & agents · Tool integration
agentmail
/agentmail
Use when an agent needs AgentMail CLI email inboxes.
For whom
- Author
- NousResearch ↗
- Repository
- hermes-agent ↗
- Licence
- MIT
- Last repository change
- 25.10.2026
Assessment and security
96/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability21 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
- Files in this package
- 6
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 6
Deprecation
No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.
Licence
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Use when an agent needs AgentMail CLI email inboxes.
Original author description
Use when an agent needs AgentMail CLI email inboxes.
How it works
- When to Use
- Prerequisites
- How to Run
- Quick Reference
- Procedure
- Pitfalls
- Verification
Original SKILL.md headings · 76 lines, 312 words
SKILL.md preview
---
name: agentmail
description: Use when an agent needs AgentMail CLI email inboxes.
version: 1.0.0
author: Haakam Aujla (Haakam21), AgentMail
license: MIT
platforms: [linux, macos, windows]
metadata:
hermes:
tags: [Email, CLI, AgentMail, Communication]
homepage: https://agentmail.to
prerequisites:
commands: [agentmail]
required_environment_variables:
- name: AGENTMAIL_API_KEY
prompt: AgentMail API key (starts with am_)
help: "Create one at https://console.agentmail.to — or run the CLI self-signup flow in references/signup.md to obtain a key without one."
required_for: "authenticating the agentmail CLI; not needed before self-signup"
optional: true
---
# AgentMail Skill
AgentMail gives an agent its own email inbox for sending mail, receiving
replies, completing email OTP flows, and running inbound email loops. Use it for
agent-owned inboxes, not a user's existing IMAP/SMTP mailbox.
Use the `agentmail` CLI first. Use MCP only when the harness expects MCP tools;
use REST only when the CLI is missing a required operation.
## When to Use
- The agent needs an email address it owns.
- The task involves email OTP flows, replies, threads, labels, or attachments.
- The agent needs webhook or WebSocket delivery for inbound mail.
## Prerequisites
- Run commands through the `terminal` tool.
- Install the CLI:
```bash
npm install -g agentmail-cli@latest
```
- Export an API key:
```bash
export AGENTMAIL_API_KEY="am_..."
```
No API key yet? Use [signup.md](references/signup.md).
## How to Run
Use `--format json` whenever another command or script needs IDs.
```bash
agentmail inboxes list --format json
```
## Quick Reference
- [AgentMail agent reference](https://agentmail.md): hosted copy.
- [AgentMail](https://agentmail.to): product landing page.
- [Console](https://console.agentmail.to): API keys and account management.
- [Docs](https://docs.agentmail.to): full product documentation.
- [signup.md](references/signup.md): self-signup and OTP verification.
- [core.md](references/core.md): inboxes, messages, threads, labels, attachments.
- [webhooks.md](references/webhooks.md): events to a public HTTPS server.
- [websockets.md](references/websockets.md): events to a local agent process.
- [mcp.md](references/mcp.md): MCP integration.
## Procedure
1. Install `agentmail-cli@latest` and verify `agentmail inboxes list --format json`.
2. If no API key is available, complete [signup.md](references/signup.md).
3. Use [core.md](references/core.md) for inbox, send, read, reply, forward,
label, thread, and attachment flows.
4. Add [webhooks.md](references/webhooks.md) or
[websockets.md](references/websockets.md) only when polling is not enough.
## Pitfalls
- Prefer `AGENTMAIL_API_KEY` over `--api-key`.
- Never expose `AGENTMAIL_API_KEY` in prompts, logs, URLs, or committed files.
- Use stable `client_id` values for retried create operations.
- Prefer `extracted_text` or `extracted_html` for LLM input when present.
- React to `message.received`, not messages the agent sent.
## Verification
```bash
agentmail inboxes list --format json
```
Files in this package (6)
- SKILL.md 3 KB
- references/core.md 3 KB
- references/mcp.md 1 KB
- references/signup.md 1 KB
- references/webhooks.md 1 KB
- references/websockets.md 1 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · NousResearch/hermes-agent | 96 | MIT |
| agentmail-to/agentmail-plugins | 100 | MIT |
| LeoYeAI/openclaw-master-skills | 100 | MIT |
Database snapshot: 13.11.2026 · package version df718cd4a0d1 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 1 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 91agentmail-file-delivery
Use to send files or attachments via AgentMail to other agents. - 95agentmail-cli
Operate AgentMail from a shell with the official CLI. Use when the user wants commands for listing or creating inboxes, reading or searching mail, sending or replying, managing drafts, or scripting JSON/YAML output; do not use for SDK code, MCP setup, or framework adapters. - 100manage-inboxes
Create, list, inspect, update, or delete AgentMail inboxes through the connected MCP server. Use for ANY inbox lifecycle request — even a quick list-inboxes or a simple delete; deletion safeguards apply regardless of task size. Also use when the user asks for a new agent email… - 81hermes-email-agentmail
Use for Hermes' own email via AgentMail. Inbox is a task queue. - 100agentmail-webhooks
Receive and verify AgentMail webhooks (email inboxes for AI agents). Use when setting up AgentMail webhook handlers, debugging Svix signature verification (svix-id, svix-timestamp, svix-signature, whsec_ secret), deduplicating on event_id, or handling events like… - 95check-mail
Check an AgentMail inbox and triage it — list unread or recent mail, read full message bodies rather than previews, and classify each one as actionable, needs-reply, FYI, or spam with a proposed next step. Also turns the periodic unread reminder on or off. Triggers on: check my…