Quellinformationen
- Repository
- NousResearch/hermes-agent
- Letzte Quellaktivität
- 27. August 2026 um 14:09
- Erkannte Sprache von SKILL.md
- Englisch
- Sterne
- 249.930
- Forks
- 53.284
Installationsoptionen
Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.
Quelldateien prüfen
Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.
Datei-Explorer
6 DateienSKILL.md wird angezeigt
SKILL.md
Quellanweisungen · Schreibgeschützte Vorschau- 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
```
Auf GitHub ansehen