MCP.Market

agentmail skill

by NousResearch·NousResearch/hermes-agent·263k stars·MIT

Use when an agent needs AgentMail CLI email inboxes.

A100/100content scan

Is the agentmail skill safe?

Clean: nothing in its files matched our rules. We read 6 files in the folder on 2026-10-25.

No findings.

Install the agentmail skill

A skill is a folder. Copy it into your agent's skills folder and the agent loads it when the task matches its description. 

git clone --depth 1 https://github.com/NousResearch/hermes-agent.git /tmp/hermes-agent
mkdir -p ~/.claude/skills
cp -r /tmp/hermes-agent/optional-skills/email/agentmail ~/.claude/skills/agentmail
available in every project

In the Claude apps, zip the folder and upload it from the Skills settings. The folder on GitHub

The instructions your agent would load

SKILL.md as published, without the frontmatter. Read it on GitHub

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

  • AgentMail agent reference: hosted copy.
  • AgentMail: product landing page.
  • Console: API keys and account management.
  • Docs: full product documentation.
  • signup.md: self-signup and OTP verification.
  • core.md: inboxes, messages, threads, labels, attachments.
  • webhooks.md: events to a public HTTPS server.
  • websockets.md: events to a local agent process.
  • mcp.md: MCP integration.

Procedure

label, thread, and attachment flows.

  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,

websockets.md only when polling is not enough.

  1. Add webhooks.md or

Pitfalls

  • Prefer AGENTMAILAPIKEY over --api-key.
  • Never expose AGENTMAILAPIKEY in prompts, logs, URLs, or committed files.
  • Use stable client_id values for retried create operations.
  • Prefer extractedtext or extractedhtml for LLM input when present.
  • React to message.received, not messages the agent sent.

Verification

agentmail inboxes list --format json

More skills from NousResearch/hermes-agent

  • A1passwordSet up op CLI, sign in, and read or inject secrets.
  • A3-statement-modelBuild integrated IS/BS/CF financial workbooks in Excel.
  • AaccelerateRun PyTorch training across GPUs with minimal changes.
  • Cactual-setupSet up Actual Computer (actual.inc) inference in Hermes.
  • Aadversarial-ux-testRoleplay a hostile user to find and triage UX pain points.
  • Aagent-merge-conflict-arbiterNeutral arbiter for merge conflicts between two agents.
  • Aai-presenter-videoMake a verified AI presenter video from script + image.
  • AairtableAirtable REST API via curl. Records CRUD, filters, upserts.
  • AanatomyExplain an idea as an interactive isometric machine figure.
  • Cantigravity-cliOperate the Antigravity CLI (agy): plugins, auth, sandbox.
  • Aapple-notesManage Apple Notes via memo CLI: create, search, edit.
  • Aapple-remindersApple Reminders via remindctl: add, list, complete.

All agent skills → · MCP servers