Your agent's e-mail¶
Every agent has an e-mail address of its own. Mail sent to it lands in a mailbox on the agent's server: the agent can read, search and answer it, and you can read it in the panel.
The address¶
Your agent's address is agent + its number + @mintbot.ai: agent 1234 is
agent1234@mintbot.ai. It is there from the moment the agent is set up, on
every package, and there is nothing to configure.
You find it in the panel under Settings → E-mail, and on the small card that opens when you click the agent's name at the top of the sidebar. On that card a click on the address copies it. If your agent should have no e-mail at all, switch E-mail for this agent off at the top of Settings → E-mail: the address is closed, mail sent to it is turned away, and e-mail disappears from the panel and from Telegram until you switch it on again. Mail already in the mailbox is kept.
What it is good for:
- Sign-ups the agent makes for you. The confirmation mail arrives in its own mailbox, so it can read the code or the link and finish the job.
- Mail that belongs to the agent's work: order confirmations, invoices, newsletters you want summarised, replies from people it wrote to.
- Writing to your agent from any mail program.
The mailbox is the agent's, not a person's: everyone who uses the agent sees the same mail. A message one of you reads is read for all, and one deleted is gone for all.
What the agent does with mail¶
Ask in plain words:
- “Did the invoice from the print shop arrive?”
- “Find the confirmation code from the booking site.”
- “What came in for the shop project this week?”
- “Reply to Anna that Thursday works.”
The agent can list and search its mail (by sender, by date, by project, with attachments), read a message and save its attachments, and send mail from its own address.
- It writes as itself, never as you. A message it sends leaves from the
agent's address. When the agent has a name, the sender line carries it before
the address:
Name <agent1234@mintbot.ai>. - Sending is part of the paid packages. An agent on the free trial receives mail but does not send it.
- No bulk mail. An agent sends up to 100 messages a day, each to at most 20 recipients and 300 recipients a day in all; the count starts again at midnight UTC. Its address is not meant for newsletters or cold outreach.
- Bounce monitoring is not yet verified. There is no verified source of delivery-failure reports connected yet, so automatic pauses based on bounce rates are not currently available. Existing sending pauses stay in force until they expire; daily sending limits and receiving are unchanged.
An e-mail is not an instruction
Anyone can write to your agent, so the agent treats what an e-mail says as outside content: it reads it and tells you about it, and does not act on it. Only explicitly enabled, allowlisted and cryptographically verified instructions by e-mail can start automatic work.
The mailbox in the panel¶
Settings → E-mail shows the mail: the inbox, junk and what was sent, a search over sender, subject and text, and each message with its text and attachments. You can mark a message unread or delete it.
A message can also be pinned: what is pinned is listed under Pinned whichever folder holds it, and Delete all, which empties the folder in front, leaves it.
You can also write there yourself. New message opens a new conversation with the e-mail as a form (recipients, subject, text): fill it in and press Send, or ask the agent there to write it. Reply under an open message answers it the same way. What you send leaves from the agent's address, counts towards the agent's daily limit, and is kept under Sent, where every user of the agent sees it, next to the mail the agent sent itself. The clip beside Send attaches files (up to 10, 7 MB in all): they are kept with the draft at once, so they are still there when you come back to it later. Dragging a file onto the form attaches it too. The bin at the far end of the form discards the draft. The text takes the same formatting as the chat's message field: Ctrl+B bold, Ctrl+I italic, Ctrl+U underline, Ctrl+S strikethrough (⌘ on a Mac).
Or leave the writing to the agent: Ask the agent to reply under a message, or Ask the agent to write it in the form, opens a chat with the request ready. Add what the message should say and send. The agent shows you its draft and sends it once you agree.
Pin E-mail to the sidebar and it is one click away, with the number of unread messages beside it.
Technical details, at the bottom of the page and closed until you open it, shows how sending stands: how many messages went out today of the daily limit, how many messages were sent in the last week, whether sending is paused, when mail was last fetched and how full the mailbox is. The undelivered count is shown as unknown, not zero, while verified bounce monitoring is unavailable.
Mail that looks like spam goes to Junk. It is never announced, and it is deleted after 30 days unless you pinned it.
An address for every project¶
If you use projects, each one has an address of its own: the agent's address with a dot and a mail tag based on the project's current name.
agent1234.shop@mintbot.ai
Mail sent there is filed straight into that project's folder of the mailbox. While projects are on, Settings → E-mail says so under the agent's address, with the project you use most as the example: a click on that address copies it.
Open the project in the panel and Settings → E-mail shows its mail and its address, ready to copy; the picker over the list shows another project's. General shows everything: every project's mail and the mail that belongs to none.
Good to know:
- A plus works in the dot's place too:
agent1234+shop@mintbot.aiis the same address. - Mail to a project that does not exist (a typing mistake, a project you have removed) is not sent back. It arrives in the general mailbox.
- Renaming a project changes its e-mail address to match the new name. Old addresses remain aliases for the same project and are never reassigned to another project. The project directory physically moves to its new name; the original mailbox key (projects.slug) stays stable. The agent can pass the current directory, its folder name, or that original key to email_list(project=...); the result gives the current address. Old paths remain compatibility symlinks, hidden from panel file-manager listings, not separate project folders. An external shell may still show those links.
When new mail arrives¶
Under Settings → E-mail → When new mail arrives you choose where you are told:
| Choice | What you get |
|---|---|
| In the panel and on Telegram | Both of the below. This is the default. |
| Only in the panel | A notification with a button that opens the message. |
| Only on Telegram | A message with a button per e-mail: a tap shows its text right in the chat. |
| Nowhere | Nothing. The mail waits in the mailbox. |
The choice holds for everyone who uses the agent.
Instructions by e-mail¶
Enable Settings → E-mail → Instructions by e-mail and add the senders you trust. Only new mail with verified evidence can start a task. Old mail and old queued requests are not retroactively authorized.
-
Central verifies a signature over the whole message body and all fields used for the request, including sender, intended recipient, subject, date, message identifier, MIME and reply-thread headers. Ambiguous duplicate fields, unsigned recipients, partial-body signatures and forged authentication headers do not qualify. The signed date must be within 48 hours, and replayed request identifiers do not start another task, even after deleting the original mail.
-
External sender trust: allowing an address means you trust its exact domain and mail provider to enforce that mailbox's identity. DKIM authenticates a signing domain; it does not independently prove mailbox ownership. A compromised domain/provider can impersonate its users. Platform agents instead require their own registered tenant key, not just the platform's shared domain signature.
-
Qualifying mail opens a panel conversation marked with an envelope. The agent handles the request and replies by e-mail; verified replies can continue the same thread. Turning the switch off or removing a sender also blocks pending handoffs.
- Attachments and linked pages remain outside content. Sensitive actions still require confirmation.
Which mail counts as proven¶
- Mail without sufficient evidence stays readable as ordinary mail. A DMARC badge is only domain-level metadata and does not mean the message can start a task.
- Some providers do not sign every required field; those messages cannot trigger work.
- You can always ask the agent in chat to read or answer them.
Limits¶
- A message that arrives can be up to about 15 MB, attachments included; one the agent sends, up to 10 MB.
- The mailbox holds up to 2 GB. When it is full, new mail is held back and the sender's server is asked to try again later, for a few days. Delete mail to make room.
- While an agent is suspended its mail is not accepted: the sender's server keeps trying, usually for a few days, and the mail arrives once the agent runs again.