AgentMail
Agent-owned email inboxes for sending, receiving, replying, and searching messages.
Tools
| Name | Description |
|---|---|
create_inboxCreate an AgentMail inbox for an agent identity. | Create an AgentMail inbox for an agent identity. |
list_inboxesList AgentMail inboxes in the organization. | List AgentMail inboxes in the organization. |
get_inboxGet an AgentMail inbox by inbox ID. | Get an AgentMail inbox by inbox ID. |
send_messageSend an email from an AgentMail inbox. | Send an email from an AgentMail inbox. |
reply_to_messageReply to an existing AgentMail message from an inbox. | Reply to an existing AgentMail message from an inbox. |
search_messagesSearch messages in an AgentMail inbox. | Search messages in an AgentMail inbox. |
get_messageRetrieve a full AgentMail message, including complete body data when available. | Retrieve a full AgentMail message, including complete body data when available. |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('agentmail', 'create_inbox', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'agentmail',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect AgentMail to my app?
Use Weavz Hosted Connect for API Key authentication. Install the SDK, create a connection through the connect portal or API, then execute tools programmatically.
What tools does AgentMail support?
AgentMail supports 7 tools including Create Inbox, List Inboxes, Get Inbox, Send Message, Reply To Message, and more.
Can I use AgentMail with AI agents?
Yes. Add AgentMail to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.
How do I connect AgentMail to ChatGPT or Claude?
Open the Weavz connector setup, sign in, choose a workspace, and add AgentMail as an approved app. ChatGPT, Claude, and other remote MCP clients can then call the scoped AgentMail tools exposed by that workspace.
Does AgentMail work with Claude Code, Cursor, Codex, and local agents?
Yes. Remote and local MCP clients can connect to a Weavz MCP endpoint for the workspace. Local coding agents can also use the Weavz CLI to inspect apps, discover actions, run approved AgentMail work, and execute Code Mode workflows from a terminal.
What can I ask an AI agent to do with AgentMail?
AgentMail exposes 7 tools, including Create Inbox, List Inboxes, Get Inbox, Send Message, Reply To Message, and more. Use Weavz to keep credentials scoped, require approval for sensitive work, and audit what the agent did.
Can AgentMail be used in stateful agent workflows?
Yes. Agents can combine AgentMail tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.
What authentication does AgentMail use?
AgentMail uses API Key. Weavz stores credentials securely and uses them for authorized action execution.
How much does the AgentMail integration cost?
The AgentMail integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
Connect AgentMail in minutes
Get 20,000 free action executions every month. No credit card required.