Tools
| Name | Description |
|---|---|
mark_email_readSets the read status of an email | Sets the read status of an email |
copy_emailCopy an email to another mailbox | Copy an email to another mailbox |
move_emailMove an email to another mailbox | Move an email to another mailbox |
delete_emailPermanently delete an email | Permanently delete an email |
Triggers
| Name | Description |
|---|---|
new_emailTrigger when a new email is received | Trigger when a new email is received |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('imap', 'mark_email_read', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'imap',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect IMAP to my app?
Use Weavz Hosted Connect for Custom authentication. Install the SDK, create a connection through the connect portal or API, then execute tools programmatically.
What tools does IMAP support?
IMAP supports 4 tools including Mark Email as Read/Unread, Copy Email, Move Email, Delete Email.
Can I use IMAP with AI agents?
Yes. Add IMAP 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 IMAP to ChatGPT or Claude?
Open the Weavz connector setup, sign in, choose a workspace, and add IMAP as an approved app. ChatGPT, Claude, and other remote MCP clients can then call the scoped IMAP tools exposed by that workspace.
Does IMAP 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 IMAP work, and execute Code Mode workflows from a terminal.
What can I ask an AI agent to do with IMAP?
IMAP exposes 4 tools, including Mark Email as Read/Unread, Copy Email, Move Email, Delete Email. Use Weavz to keep credentials scoped, require approval for sensitive work, and audit what the agent did.
Can IMAP be used in stateful agent workflows?
Yes. Agents can combine IMAP 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 IMAP use?
IMAP uses Custom. Weavz stores credentials securely and uses them for authorized action execution.
How much does the IMAP integration cost?
The IMAP integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
What triggers does IMAP support?
IMAP supports 1 triggers including New Email.
Connect IMAP in minutes
Get 20,000 free action executions every month. No credit card required.