Home / Tools / agentmail.list_messages

AgentMail List Messages

Free

Tool ID: agentmail.list_messages

List received and sent messages in an inbox on your own AgentMail account. Requires your own AgentMail API key via X-Provider-Key (0% Helve fee) for strict per-user mailbox isolation.

Provider
agentmail
Category
Utilities & Media
Pricing
BYO key only ($0.00 Helve fee; pass X-Provider-Key)
Replaces Signup
Unified AgentMail schema (pass your own AgentMail key via X-Provider-Key)
Get API Key ($1.00 Free Credit) Browse All 334 Tools

Input Parameters

ParameterTypeRequiredDescription
inbox_idstringRequiredInbox email address or ID returned by agentmail.list_inboxes or agentmail.create_inbox
limitintegerRequiredMaximum number of messages to return (1-100)
page_tokenstringOptionalOptional pagination cursor from a previous response

Call via REST API

curl -X POST https://helve.dev/v1/tools/call \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "tool_id": "agentmail.list_messages",
  "arguments": {
    "inbox_id": "agent@agentmail.to",
    "limit": 10
  }
}'

Call via MCP (call_tool)

{
  "name": "call_tool",
  "arguments": {
    "tool_id": "agentmail.list_messages",
    "arguments": {
      "inbox_id": "agent@agentmail.to",
      "limit": 10
    }
  }
}

Related Utilities & Media Tools

Resend Send Transactional Email
resend.send_email

Send a transactional email via Resend. Supports plain text and HTML bodies. Requires your own Resend API key via the X-Provider-Key header (0% Helve fee; stateless, never stored) for sender domain isolation.

View schema →
AgentMail List Inboxes
agentmail.list_inboxes

List AI agent email inboxes on your own AgentMail account. Requires your own AgentMail API key via X-Provider-Key (0% Helve fee) for strict per-user mailbox isolation.

View schema →
AgentMail Create Inbox
agentmail.create_inbox

Provision a dedicated AI agent email inbox on your own AgentMail account. Requires your own AgentMail API key via X-Provider-Key (0% Helve fee) for strict per-user mailbox isolation.

View schema →
AgentMail Send Message
agentmail.send_message

Send an email from an inbox on your own AgentMail account. Requires your own AgentMail API key via X-Provider-Key (0% Helve fee) for strict per-user mailbox isolation.

View schema →