Agent Mail
Receive email directly into a mobilerun-hosted inbox. Query messages and extract email OTPs without an external account.
- Receive
- Yes
- Send
- Not in the documented API
- Best for
- Verification and machine-readable intake
Agent Mail
Give every agent an inbox it can read.
Claim a permanent inbound email address over the API. Receive and filter messages, inspect the useful fields, and pull the best OTP without opening Gmail.
$2 per mailbox / month
1,000 inbound messages included Pricing →
1,000 inbound messages included Pricing →
Inbound email by API. For outbound email, use Gmail automation.
mailbox onboarding-agent-42
active address
onboarding-agent-42@… permanent best OTP042911
confidencehigh
sourcemessage
What the API gives you
An inbox built for software, not tabs.
@
A stable email identity
Choose a local part or get a random, non-guessable one. The address stays reserved even when the mailbox is archived.
↳
Messages as data
Filter by sender, receive time, or OTP presence. Retrieve sender, subject, text body, preview, and attachment metadata.
•••
OTP without parsing
Ask for the strongest recent candidate and narrow it by sender, time, or code length. Leading zeros stay intact.
TypeScript + Python
Claim. Poll. Continue the run.
Agent Mail uses the same bearer key and generated SDKs as the rest of mobilerun. Claims are idempotent, so retries do not create another mailbox.
- Included-first or rentedCheck live package capacity before claiming.
- Lifecycle stays explicitProvisioning, active, cancellation and archive states are all returned.
- The address survivesRestart an archived mailbox on its original address.
agent-mail.ts
import Mobilerun from '@mobilerun/sdk';
const client = new Mobilerun();
const mailbox = await client.mailboxes.create({
clientRequestId: 'onboarding-agent-42',
localPart: 'onboarding-agent-42',
});
// Once active, check for the newest code. Repeat until it arrives.
const otp = await client.mailboxes.otp(mailbox.data.id, {
sender: 'accounts@vendor.example',
minLength: 6,
maxLength: 6,
});
if (!otp) {
console.log('No matching OTP yet. Poll again shortly.');
} else {
console.log(otp.data.code, otp.data.confidence);
} Three different channels
Pick the identity the task actually needs.
Agent Mail, Gmail and SMS work together, but they are not interchangeable.
Gmail automation
Drive your own Gmail account in the real mobile app. Read, triage, compose, send, reply, attach files, and complete app flows.
- Receive
- Yes, through Gmail
- Send
- Yes, through the app
- Best for
- Human inbox workflows
Agent SMS
Use a real number and eSIM. Read inbox and outbox messages, group threads, track delivery state, and send SMS over the API.
- Receive
- Yes
- Send
- Yes, asynchronously
- Best for
- Phone verification and SMS workflows
FAQ
Agent Mail, without ambiguity.
What is Agent Mail?+
Agent Mail is a mobilerun-hosted inbound email address that an agent manages over the API. It can retrieve incoming messages and pull OTP codes without opening a mail app or connecting an external inbox.
Can Agent Mail send or reply to email?+
Not through the currently documented Agent Mail API. Agent Mail covers inbound email. To compose, send, reply, or work with full attachments, the agent can drive your authorized Gmail account in the real mobile app.
How much does Agent Mail cost?+
Agent Mail starts at $2 per month for one mailbox, including 1,000 inbound messages per month. If your package includes mailbox capacity, the API can claim that capacity first instead of starting a separate rental.
Give the agent its own inbox.
Claim a permanent address, receive the next message, and let the run continue without opening another app.