Connect AgentMail to Your AI Agent

Tell AI which inbox and topic to read, then ask for decisions, open questions, or a draft based on the messages.

Try a AgentMail Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill AgentMail

Summarize a Topic

Find inbox threads and extract decisions and unresolved questions.

/oo AgentMail: Search AgentMail inbox [inbox ID] for [topic] during [date range]. Read matching threads and summarize decisions, deadlines, and unanswered questions.

Save a Reply Draft

Read a message and save proposed reply wording for review without sending.

/oo AgentMail: Read AgentMail message [message ID] in inbox [inbox ID]. Save a reply draft to [recipient] addressing [instructions], linked to that message. Do not send it.

Start Working with AgentMail

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect AgentMail

Connect your AgentMail API key.
Connect AgentMail →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

A key with access to the intended inbox or pod.
Specify the inbox ID and whether a message should be saved as a draft or sent. Search results can require more than one page.

AgentMail Tools

AgentMail provides inboxes, messages, threads, and drafts for email workflows. The connection also manages domains and pod-scoped resources, while draft creation and sending remain separate operations.

Read Messages and Threads

Find message history and read individual messages or inbox threads.

Prepare and Send Drafts

Create and update drafts, inspect them, and send only when instructed.

Manage Inboxes

List and inspect inboxes or create a separate inbox for a workflow.

102 tools

Create Inbox

Create a new AgentMail inbox.

agent_mail.create_inbox

List Inboxes

List inboxes available to the current AgentMail API key.

agent_mail.list_inboxes

Get Inbox

Get a single AgentMail inbox.

agent_mail.get_inbox

Update Inbox

Update an AgentMail inbox display name or metadata.

agent_mail.update_inbox

Delete Inbox

Delete an AgentMail inbox.

agent_mail.delete_inbox

List Inbox Threads

List threads in a specific AgentMail inbox.

agent_mail.list_inbox_threads

Search Inbox Threads

Search threads in a specific AgentMail inbox.

agent_mail.search_inbox_threads

Get Inbox Thread

Get a single thread from a specific AgentMail inbox.

agent_mail.get_inbox_thread

Update Inbox Thread

Update labels on a thread in a specific AgentMail inbox.

agent_mail.update_inbox_thread

Delete Inbox Thread

Delete a thread from a specific AgentMail inbox.

agent_mail.delete_inbox_thread

Get Inbox Thread Attachment

Get metadata and download URL for an attachment in an AgentMail inbox thread.

agent_mail.get_inbox_thread_attachment

List Messages

List messages from a specific AgentMail inbox.

agent_mail.list_messages

Search Messages

Search messages in a specific AgentMail inbox.

agent_mail.search_messages

Get Message

Get a single message from a specific AgentMail inbox.

agent_mail.get_message

Update Message

Update labels on a message in a specific AgentMail inbox.

agent_mail.update_message

Batch Get Messages

Fetch multiple messages from a specific AgentMail inbox by message ID.

agent_mail.batch_get_messages

Get Message Attachment

Get metadata and download URL for an attachment on a specific AgentMail message.

agent_mail.get_message_attachment

Get Raw Message

Get a presigned download URL for the raw EML version of an AgentMail message.

agent_mail.get_raw_message

Send Message

Send a message from a specific AgentMail inbox.

agent_mail.send_message

Reply To Message

Reply to a specific AgentMail message.

agent_mail.reply_to_message

Reply All Message

Reply to all recipients of a specific AgentMail message.

agent_mail.reply_all_message

Forward Message

Forward a specific AgentMail message.

agent_mail.forward_message

List Drafts

List drafts from a specific AgentMail inbox.

agent_mail.list_drafts

Create Draft

Create a draft in a specific AgentMail inbox.

agent_mail.create_draft

Get Draft

Get a draft from a specific AgentMail inbox.

agent_mail.get_draft

Update Draft

Update a draft in a specific AgentMail inbox.

agent_mail.update_draft

Delete Draft

Delete a draft from a specific AgentMail inbox.

agent_mail.delete_draft

Get Draft Attachment

Get metadata and download URL for an attachment on a specific AgentMail draft.

agent_mail.get_draft_attachment

Send Draft

Send a specific AgentMail draft.

agent_mail.send_draft

List Inbox List Entries

List allow or block entries scoped to a specific AgentMail inbox.

agent_mail.list_inbox_list_entries

Create Inbox List Entry

Create an allow or block list entry scoped to a specific AgentMail inbox.

agent_mail.create_inbox_list_entry

Get Inbox List Entry

Get an allow or block list entry scoped to a specific AgentMail inbox.

agent_mail.get_inbox_list_entry

Delete Inbox List Entry

Delete an allow or block list entry scoped to a specific AgentMail inbox.

agent_mail.delete_inbox_list_entry

Query Inbox Metrics

Query AgentMail metrics scoped to a specific inbox.

agent_mail.query_inbox_metrics

List Inbox Events

List events scoped to a specific AgentMail inbox.

agent_mail.list_inbox_events

List Inbox Api Keys

List API keys scoped to a specific AgentMail inbox.

agent_mail.list_inbox_api_keys

Create Inbox Api Key

Create an API key scoped to a specific AgentMail inbox.

agent_mail.create_inbox_api_key

Delete Inbox Api Key

Delete an API key scoped to a specific AgentMail inbox.

agent_mail.delete_inbox_api_key

List Threads

List AgentMail threads across accessible inboxes.

agent_mail.list_threads

Search Threads

Search AgentMail threads across accessible inboxes.

agent_mail.search_threads

Get Thread

Get a single AgentMail thread.

agent_mail.get_thread

Update Thread

Update labels on an AgentMail thread.

agent_mail.update_thread

Delete Thread

Delete an AgentMail thread.

agent_mail.delete_thread

Get Thread Attachment

Get metadata and download URL for an attachment in an AgentMail thread.

agent_mail.get_thread_attachment

List Global Drafts

List AgentMail drafts across accessible inboxes.

agent_mail.list_global_drafts

Get Global Draft

Get a single AgentMail draft across accessible inboxes.

agent_mail.get_global_draft

Get Global Draft Attachment

Get metadata and download URL for an attachment on an AgentMail draft.

agent_mail.get_global_draft_attachment

List Webhooks

List AgentMail webhooks.

agent_mail.list_webhooks

Create Webhook

Create an AgentMail webhook.

agent_mail.create_webhook

Get Webhook

Get a single AgentMail webhook.

agent_mail.get_webhook

Update Webhook

Update an AgentMail webhook.

agent_mail.update_webhook

Delete Webhook

Delete an AgentMail webhook.

agent_mail.delete_webhook

List Domains

List AgentMail domains.

agent_mail.list_domains

Create Domain

Create an AgentMail domain.

agent_mail.create_domain

Get Domain

Get a single AgentMail domain.

agent_mail.get_domain

Update Domain

Update an AgentMail domain.

agent_mail.update_domain

Delete Domain

Delete an AgentMail domain.

agent_mail.delete_domain

Get Domain Zone File

Get the DNS zone file records needed for an AgentMail domain.

agent_mail.get_domain_zone_file

Verify Domain

Ask AgentMail to verify a domain's DNS records.

agent_mail.verify_domain

List List Entries

List global AgentMail allow or block entries.

agent_mail.list_list_entries

Create List Entry

Create a global AgentMail allow or block list entry.

agent_mail.create_list_entry

Get List Entry

Get a global AgentMail allow or block list entry.

agent_mail.get_list_entry

Delete List Entry

Delete a global AgentMail allow or block list entry.

agent_mail.delete_list_entry

Query Metrics

Query AgentMail metrics across accessible resources.

agent_mail.query_metrics

List Api Keys

List AgentMail API keys.

agent_mail.list_api_keys

Create Api Key

Create an AgentMail API key.

agent_mail.create_api_key

Delete Api Key

Delete an AgentMail API key.

agent_mail.delete_api_key

List Pods

List AgentMail pods.

agent_mail.list_pods

Create Pod

Create an AgentMail pod.

agent_mail.create_pod

Get Pod

Get a single AgentMail pod.

agent_mail.get_pod

Delete Pod

Delete an AgentMail pod.

agent_mail.delete_pod

List Pod Inboxes

List AgentMail inboxes scoped to a pod.

agent_mail.list_pod_inboxes

Create Pod Inbox

Create an AgentMail inbox scoped to a pod.

agent_mail.create_pod_inbox

Get Pod Inbox

Get a single AgentMail inbox scoped to a pod.

agent_mail.get_pod_inbox

Update Pod Inbox

Update an AgentMail inbox scoped to a pod.

agent_mail.update_pod_inbox

Delete Pod Inbox

Delete an AgentMail inbox scoped to a pod.

agent_mail.delete_pod_inbox

List Pod Threads

List AgentMail threads scoped to a pod.

agent_mail.list_pod_threads

Search Pod Threads

Search AgentMail threads scoped to a pod.

agent_mail.search_pod_threads

Get Pod Thread

Get a single AgentMail thread scoped to a pod.

agent_mail.get_pod_thread

Update Pod Thread

Update labels on an AgentMail thread scoped to a pod.

agent_mail.update_pod_thread

Delete Pod Thread

Delete an AgentMail thread scoped to a pod.

agent_mail.delete_pod_thread

Get Pod Thread Attachment

Get metadata and download URL for an attachment in an AgentMail pod thread.

agent_mail.get_pod_thread_attachment

List Pod Drafts

List AgentMail drafts scoped to a pod.

agent_mail.list_pod_drafts

Get Pod Draft

Get a single AgentMail draft scoped to a pod.

agent_mail.get_pod_draft

Get Pod Draft Attachment

Get metadata and download URL for an attachment on an AgentMail pod draft.

agent_mail.get_pod_draft_attachment

List Pod Domains

List AgentMail domains scoped to a pod.

agent_mail.list_pod_domains

Create Pod Domain

Create an AgentMail domain scoped to a pod.

agent_mail.create_pod_domain

Get Pod Domain

Get a single AgentMail domain scoped to a pod.

agent_mail.get_pod_domain

Update Pod Domain

Update an AgentMail domain scoped to a pod.

agent_mail.update_pod_domain

Delete Pod Domain

Delete an AgentMail domain scoped to a pod.

agent_mail.delete_pod_domain

Get Pod Domain Zone File

Get the DNS zone file records needed for an AgentMail pod domain.

agent_mail.get_pod_domain_zone_file

Verify Pod Domain

Ask AgentMail to verify a pod domain's DNS records.

agent_mail.verify_pod_domain

List Pod List Entries

List AgentMail allow or block entries scoped to a pod.

agent_mail.list_pod_list_entries

Create Pod List Entry

Create an AgentMail allow or block list entry scoped to a pod.

agent_mail.create_pod_list_entry

Get Pod List Entry

Get an AgentMail allow or block list entry scoped to a pod.

agent_mail.get_pod_list_entry

Delete Pod List Entry

Delete an AgentMail allow or block list entry scoped to a pod.

agent_mail.delete_pod_list_entry

Query Pod Metrics

Query AgentMail metrics scoped to a pod.

agent_mail.query_pod_metrics

List Pod Api Keys

List AgentMail API keys scoped to a pod.

agent_mail.list_pod_api_keys

Create Pod Api Key

Create an API key scoped to a specific AgentMail pod.

agent_mail.create_pod_api_key

Delete Pod Api Key

Delete an API key scoped to a specific AgentMail pod.

agent_mail.delete_pod_api_key

Get Organization

Get the AgentMail organization available to the current API key.

agent_mail.get_organization

Who Am I

Get AgentMail identity information for the current API key.

agent_mail.who_am_i

Frequently Asked Questions

What should I include in an inbox summary request?

Provide the inbox ID, topic, and date range. Ask for specific outputs such as decisions or questions and request source message or thread IDs.

Can I save a reply without sending it?

Yes. Draft creation saves the message for review. Sending a draft is a separate operation and should be requested explicitly.

Can I read every inbox with one key?

Access follows the key’s permissions and resource scope. Supply the correct inbox or pod identifier and use a key authorized for that resource.