AGENT SKILL

agentmail

Use when an agent needs AgentMail CLI email inboxes.

License 许可
MIT
所属仓库
fengwhang/mercury
最近更新
2026-10-09
Stars
★ 0
Forks
0

01 前言 Front Matter

name
agentmail
author
Haakam Aujla (Haakam21), AgentMail
license
MIT
version
1.0.0
metadata
{ "mercury": { "tags": [ "Email", "CLI", "AgentMail", "Communication" ], "homepage": "https://agentmail.to" } }
platforms
[ "linux", "macos", "windows" ]
description
Use when an agent needs AgentMail CLI email inboxes.
prerequisites
{ "commands": [ "agentmail" ] }
required_environment_variables
[ { "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.", "name": "AGENTMAIL_API_KEY", "prompt": "AgentMail API key (starts with am_)", "optional": true, "required_for": "authenticating the agentmail CLI; not needed before self-signup" } ]

02 资源文件 5

03 SKILL.md 正文

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:
npm install -g agentmail-cli@latest
  • Export an API key:
export AGENTMAIL_API_KEY="am_..."

No API key yet? Use signup.md.

How to Run

Use --format json whenever another command or script needs IDs.

agentmail inboxes list --format json

Quick Reference

Procedure

  1. Install agentmail-cli@latest and verify agentmail inboxes list --format json.
  2. If no API key is available, complete signup.md.
  3. Use core.md for inbox, send, read, reply, forward, label, thread, and attachment flows.
  4. Add webhooks.md or 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

agentmail inboxes list --format json

04 同仓库更多 Skills