# agentmail

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

Build with the AgentMail TypeScript or Python SDK for inbox, message, thread, draft, attachment, domain, allow/block list, pod, webhook, and WebSocket workflows, including programmatic agent sign-up, domain/DNS administration, and deliverability triage (bounces, spam, blocked mail). Use when implementing or reviewing AgentMail API code; do not use for direct mailbox operations, CLI usage, MCP setup, or framework-toolkit integration.

## Install

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

## From README

AgentMail SDK AgentMail is an API-first email platform for AI agents. Use the published SDK interfaces and generated API types as the source of truth. Keep credentials in AGENTMAILAPIKEY. Create an inbox, send, and read a reply. Full per-language lives in the references. Core rules If no AgentMail MCP server is connected, use the SDK directly. Use positional arguments for TypeScript path parameters, such as get(inboxId) and send(inboxId, request). Use CreateInboxRequest for configured organization-level inbox creation in Python. Fetch a full message or thread before reading body content; list responses can contain summaries only. For inbound replies, use extractedtext / extractedhtml, not text / html — they strip quoted history and signatures. Some clients (Gmail, Outlook) send forwards as HTML-only, so treat html as the primary fallback and text as optional. Reply and forward with a message ID, not a thread ID.

## Links

- HTML page: https://omgskills.com/library/agentmail-to/agentmail-plugins/skills/agentmail/
- 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-cli](https://omgskills.com/library/agentmail-to/agentmail-plugins/skills/agentmail-cli/index.md) — Operate AgentMail from a shell with the official CLI.
   - [@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