# agentmail-cli

> Claude/Codex skill by [@agentmail-to](https://omgskills.com/library/agentmail-to/index.md) · 36 stars · Updated 2026-10-06

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.

## Install

```sh
git clone https://github.com/agentmail-to/agentmail-plugins /tmp/agentmail-plugins && ln -s /tmp/agentmail-plugins/skills/agentmail-cli ~/.claude/skills/agentmail-cli
```

## From README

AgentMail CLI the CLI and provide the API key through the environment. A resource nested under another is a nested subcommand, e.g. inboxes messages, inboxes threads, pods inboxes, pods threads (CLI 1.x; the colon form inboxes:messages is rejected). Run agentmail --help to list what a resource supports. Inboxes Confirm the exact inbox before running the destructive delete command. Messages and threads Use a message ID for replies. Fetch the full message before relying on body content. Drafts Pods Pods group inboxes together.

## Links

- HTML page: https://omgskills.com/library/agentmail-to/agentmail-plugins/skills/agentmail-cli/
- GitHub: https://github.com/agentmail-to/agentmail-plugins
- Author: [@agentmail-to](https://omgskills.com/library/agentmail-to/index.md)

## More from this repo

- [agent-email-patterns](https://omgskills.com/library/agentmail-to/agentmail-plugins/skills/agent-email-patterns/index.md) — Architecture patterns for AI agents that communicate over email -- why agents need dedicated inboxes rather than human...
   - [@agentmail-to](https://omgskills.com/library/agentmail-to/index.md) · 36 stars
- [agentmail](https://omgskills.com/library/agentmail-to/agentmail-plugins/skills/agentmail/index.md) — Used to build with the AgentMail TypeScript or Python SDK for inbox, message, thread, draft, attachment, domain,...
   - [@agentmail-to](https://omgskills.com/library/agentmail-to/index.md) · 36 stars
- [agentmail-mcp](https://omgskills.com/library/agentmail-to/agentmail-plugins/skills/agentmail-mcp/index.md) — Configure or troubleshoot the hosted AgentMail MCP server for Codex, Claude Code, Cursor, Claude.ai, ChatGPT, or...
   - [@agentmail-to](https://omgskills.com/library/agentmail-to/index.md) · 36 stars