agentmail

name	agentmail
description	Give Gorkie email access through AgentMail. Use when the user asks Gorkie to send email, read email, inspect inboxes, reply to messages, handle attachments, draft mail for approval, or set up email notifications.

AgentMail

Gorkie owns the inbox [e-mail]. Use AgentMail from Python inside the sandbox when the user asks to send, receive, search, reply to, draft, or inspect email.

Credentials

Use this placeholder:

from agentmail import AgentMail

client = AgentMail(api_key="brokered-by-gorkie")

The placeholder is not a secret. It only makes the SDK construct authenticated requests. Gorkie's host can inject the real Authorization header through the sandbox network policy. Never print API keys, bearer headers, or credential-broker internals.

Ground Rules

• Use [e-mail] unless the user names another inbox.
• Prefer drafts for sensitive, external, broad, or ambiguous messages.
• Send directly only when the user clearly asked for the exact recipient, subject, and body.
• Before sending attachments, confirm the path exists and check size with ls -lh.
• Summarize recipient addresses, subject, body intent, labels, and attachment filenames after any send or draft.
• Do not expose private message bodies unless the user asked to inspect them.
• Do not set up webhook forwarding to third-party URLs without explicit approval.

Common Workflows

List recent mail:

from agentmail import AgentMail

client = AgentMail(api_key="brokered-by-gorkie")
messages = client.inboxes.messages.list(inbox_id="[e-mail]")
for message in messages:
    print(message)

Send plain text mail:

client.inboxes.messages.send(
    inbox_id="[e-mail]",
    to="[e-mail]",
    subject="Hello",
    text="Plain text body",
)

Create a draft for user approval:

draft = client.inboxes.drafts.create(
    inbox_id="[e-mail]",
    to="[e-mail]",
    subject="Pending approval",
    text="Draft content",
)
print(draft)

References

• Full Python inbox, message, thread, draft, attachment, pod, and label examples: Core API.
• Webhook creation and signature verification: Webhooks.
• WebSocket subscriptions for live inbox events: WebSockets.