Programmatic email for AI agents via AgentMail API. Create inboxes, send/receive messages, manage threads, webhooks, pods, and custom domains. Use when you need agent email identity, email-based workflows, or real-time email processing.
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.
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.
Programmatic email for AI agents via AgentMail API. Create inboxes, send/receive messages, manage threads, webhooks, pods, and custom domains. Use when you need agent email identity, email-based workflows, or real-time email processing.
version
1.1.0
AgentMail Skill
Purpose: Programmatic email for AI agents via AgentMail API — create inboxes, send/receive messages, manage threads, webhooks, and domains.
Requires AGENTMAIL_API_KEY environment variable. Get your key from https://agentmail.to
Core Concepts
Inbox: Email address (e.g., random123@agentmail.to) that can send/receive
Pod: Container for multiple inboxes with shared domains
Thread: Email conversation (grouped by subject/references)
Message: Individual email in a thread
Draft: Unsent message that can be edited before sending
CLI Wrapper
Use the agentmail-cli script for common operations:
# List inboxes
./scripts/agentmail-cli inboxes list
# Create inbox
./scripts/agentmail-cli inboxes create [--username NAME] [--domain DOMAIN]
# Send email
./scripts/agentmail-cli send --inbox-id ID --to --subject --text
./scripts/agentmail-cli messages list --inbox-id ID
./scripts/agentmail-cli messages get --inbox-id ID --message-id MSG_ID
./scripts/agentmail-cli reply --inbox-id ID --message-id MSG_ID --text
./scripts/agentmail-cli threads list --inbox-id ID
./scripts/agentmail-cli webhooks create --url --events
./scripts/agentmail-cli webhooks list
"email@example.com"
"Hello"
"Body"
# List messages
# Get message
# Reply to message
"Reply body"
# List threads
# Create webhook
"https://..."
"message.received"
# List webhooks
Python SDK (Direct Usage)
from agentmail import AgentMail
client = AgentMail(api_key="YOUR_API_KEY")
# Create inbox
inbox = client.inboxes.create()
print(f"Created: {inbox.address}")
# Send message
response = client.inboxes.messages.send(
inbox_id=inbox.id,
to=["recipient@example.com"],
subject="Hello from Agent",
text="This is the message body",
html="<p>This is the <b>HTML</b> body</p>"# optional
)
# List messages in inbox
messages = client.inboxes.messages.list(inbox_id=inbox.id)
for msg in messages:
print(f"{msg.from_} -> {msg.subject}")
# Reply to a message
client.inboxes.messages.reply(
inbox_id=inbox.id,
message_id=message_id,
text="Thanks for your email!"
)
# Forward a message
client.inboxes.messages.forward(
inbox_id=inbox.id,
message_id=message_id,
to=["another@example.com"]
)
# Create pod
pod = client.pods.create(name="my-project")
# Create inbox in pod
inbox = client.pods.inboxes.create(
pod_id=pod.id,
username="support",
domain="agentmail.to"# or your verified domain
)
# List all inboxes in pod
inboxes = client.pods.inboxes.list(pod_id=pod.id)
Custom Domains
# Register domain
domain = client.domains.create(
domain="mail.yourdomain.com",
feedback_enabled=True
)
# Get DNS records to configure
zone_file = client.domains.get_zone_file(domain_id=domain.id)
# Verify domain after DNS setup
client.domains.verify(domain_id=domain.id)
