Allow-list mode
Set an agent’s default to deny and it sees nothing unless a thread carries co:investor-relations. Best for focused agents that only need specific conversations, like bookkeeping or investor updates.
Features
Every agent gets a co:agent-name label in your Gmail account to grant access to a thread, and an optional no:agent-name label to block one. Gmail filters and comail rules apply co: for you, and comail checks the thread’s live labels on every API call.
One inbox, three agents. Want to audit exactly what an agent can read? Search label:"co:investor-relations" in Gmail on your laptop or phone. And because comail hides its labels from your sidebar and inbox list by default, they won’t clutter your day-to-day view.
Set an agent’s default to deny and it sees nothing unless a thread carries co:investor-relations. Best for focused agents that only need specific conversations, like bookkeeping or investor updates.
Set an agent’s default to allow and it can read the whole inbox except threads labeled no:triage or excluded by label, address, or domain. Useful for a general triage assistant when you only need to wall off sensitive senders or topics.
no: always winsWhen turned on, no: always overrides co:. A broad rule can share a whole domain with an agent while you add no:agent-name to one sensitive thread from your phone. Manual labels are never overwritten by rules.
Controls
| Permission | What the agent can do | How it’s set |
|---|---|---|
view |
Search, list, and read threads | Per thread: the agent’s co: and no: labels, plus its default policy for unlabeled threads |
draft |
Create, edit, and delete its own drafts | Always on for every agent |
send |
Send mail from your address | Per agent: drafts only (default), specific people, or anyone |
review |
Approve and send another agent’s draft unchanged, or return it with feedback | Per agent (off by default): choose which agents it can review and who it may send to |
attachments |
Read attachment contents (when off, the agent only sees filenames and sizes) | Per agent (on by default) |
archive |
Archive or unarchive threads, mark mail read or unread, and star messages | Per agent (on by default) |
spam |
Move threads to spam or back to the inbox, and unsubscribe from mailing lists through a signed one-click link | Per agent (on by default) |
trash |
Move threads to the trash or restore them | Per agent (off by default) |
labels |
Create sublabels under co:agent-name/ and apply them to threads |
Per agent (off by default) |
Resolution order is simple: when turned on, no: overrides co:, and co: overrides the default policy. comail checks labels live on every request, not just when an email arrives, so removing a label cuts off access immediately. An agent cannot reply to, forward, or modify a thread it cannot view, and it can never widen its own access by adding its co: label or removing its no: label.
| Inbox | What chief-of-staff sees there | Default | Access |
|---|---|---|---|
you@company.com |
Threads carrying co:chief-of-staff |
deny | active |
founders@company.com |
Everything except no:chief-of-staff |
allow | active |
you@personal.com |
Threads carrying co:chief-of-staff |
deny | paused |
One MCP URL across multiple accounts. Each inbox gets its own labels and default policy, so the same agent can use an allow-list on your individual work email and a deny-list on a shared team address. You can pause an agent in one inbox (or all of them) from the dashboard; its credentials and labels stay intact for when you resume, and any scheduled sends wait in the meantime.
| Capability | Gmail itself | Web dashboard |
|---|---|---|
| Share a thread with an agent, or take it back | ||
| Label threads automatically as they arrive | Gmail filters | comail rules |
| Hide an agent’s labels from your inbox | ||
| Pause an agent in one inbox, or in all of them | ||
| Add, deactivate, and revoke agents | ||
| Delegate setup to an agent management MCP, time-boxed or pausable | ||
| Switch an agent between allow-list and deny-list | ||
| Configure send, review, attachment, archive, spam, trash, and label permissions | ||
| Billing and account |
Day-to-day access happens right in Gmail: sharing a thread or taking it back is just adding or removing a label on desktop or mobile. The web dashboard handles setup, permissions, and rules.
Agents can also wake up when new mail arrives, with no webhook server or polling: see live notifications. Or browse the use cases built on these controls.
We’re onboarding beta users in small batches. Tell us what you want your agent to handle; specific use cases go to the front of the line.