manage-inboxes

name	manage-inboxes
description	Create, list, inspect, update, or delete AgentMail inboxes through the connected MCP server. Use when the user asks for a new agent email address, wants to inspect available inboxes, change an inbox display name or metadata, or remove an inbox.

Manage Inboxes

Use AgentMail MCP inbox tools while preserving the user’s intended address, scope, and data.

Workflow

• Use list_inboxes to discover inboxes and get_inbox for exact details.
• Use create_inbox only after the user asks for a new inbox. Pass a requested username, verified domain, display name, metadata, and client ID when supplied.
• Use update_inbox for display-name or metadata changes. Explain that metadata keys merge and that setting keys to null removes them.
• Use delete_inbox only after showing the exact inbox ID/address and receiving explicit confirmation. Deletion is destructive and can remove access to its mail.
• Return the inbox ID, email address, pod scope, display name, metadata, and creation time when relevant.

Guardrails

• Do not invent a custom domain or assume it is verified.
• Use a stable client ID when the caller needs idempotent inbox creation.
• Do not broaden an inbox- or pod-scoped credential beyond its current scope.
• Never expose API keys or unrelated mailbox data in the result.