a gmail assistant that sorts, drafts and briefs you

what a bot can do in Gmail

a bot works in gmail through the same actions a person would use: it searches, opens a thread, adds a label, saves a draft. here are the ones that come up most in real inbox work.

composio, the connection service dusk bot uses for apps, lists 63 Gmail actions (catalog version 20261105_00, read 12 november 2026⁵). dusk bot treats 25 of them as reads, 8 as sends and the other 30 as changes. an action counts as a read only when its name starts with a read word like get, list or search, so a bot you allow only to read can never call the rest. a send is anything that reaches a person outside the app or moves money, like modify email labels: it waits for your Allow unless you've given that bot a daily amount it may send alone.

connect Gmail

1. open Connected apps in the sidebar.
2. pick Gmail and sign in on Gmail's own page, so your password goes to them and never to a bot.
3. choose which bots may use it, and whether each may only read or may also change things. your bookkeeper doesn't need your Gmail.
4. ask in plain words. reading and drafting happen freely; sending asks you first.

you can connect more than one gmail account. give each a label when you connect it, like work or personal, and tell the bot which one you mean. up to five accounts per app can be connected at once.

on dusk cloud connected apps are included; on your own computer the app connects through dusk bot's own connection service by default, so there is no key to set up.

routines to copy

a routine is a job a bot does without being asked again. you make one by sending it, in plain words. these three are a good start; change the times and the words to fit you.

every weekday at 8, read what came into my gmail since yesterday evening. tell me the 3 to 5 things that need me today, one line each, with who it's from. skip newsletters and receipts. don't reply to anything.

whenever an email arrives from anyone at @acme.com, read the whole thread and draft a reply in my voice: short, friendly, no exclamation marks. leave it in drafts and tell me it's there. never send it yourself.

every friday at 4, find this week's receipts and invoices in gmail, add the label receipts to each, and give me a table of sender, amount and date. if an amount is over $500, put it at the top.

what it asks you first

reading and drafting happen on their own. anything that leaves your outbox, like sending, replying or forwarding, stops and shows you a card with Allow and Deny first, in the app, on your phone or in a call. you can let a bot send a daily amount on its own instead, and you choose that per bot. one thing to know: a bot on Full access that has no sending rule of its own may send up to 25 a day without asking, so give a full-access bot Ask every time under sending.

before a bot touches gmail at all, it has to be one you allowed in Connected apps, and you can keep it to reading only. a bot that may only read cannot label, draft, trash or send; dusk bot refuses those calls before they reach google.

the gmail sign-in happens on google's own page. your google password never reaches a bot, and dusk bot does not keep gmail's sign-in tokens: composio, the connection service, holds the connection, and Disconnect removes it there too.

what it cannot do

• create gmail filters, set your vacation responder, or change imap, pop, forwarding and send-as settings with the standard connection. google asks for extra permissions for those that the standard connection doesn't request, and the bot will tell you so instead of retrying. with your own composio project you can add them.
• keep watching while your computer sleeps. on your own computer, routines and new-mail reactions pause when it's asleep or the app is closed; a run missed by less than 12 hours runs once when you're back. on dusk cloud they keep going.
• react the very second mail lands. gmail is checked about every 15 minutes, so a "whenever an email arrives" routine can take that long to start.
• read more than five gmail accounts at once, or an account you connected somewhere else. each account is connected from dusk bot, with its own label.
• unsend. once you allow a send, it's gone, like any email you send yourself.

which ai does the work

dusk bot has no model of its own. each bot thinks with an ai you sign in to on your own computer, like claude, chatgpt, gemini or grok, or an api key, or a model you run yourself. your inbox bot can use one and your researcher another, and you can switch either at any time without losing chats or memory.

so "claude for gmail" and "chatgpt for gmail" are the same setup here: connect gmail once, then pick the ai in the bot's model picker. what you say to the bot goes from your machine to that ai on your plan with them, not through us. what the bot does inside gmail goes to google through our relay and composio.

make it remember how you write

tell the bot once and it keeps a note: "i sign off with just my first name", "dana approves anything over $500", "never draft replies to recruiters". the notes are plain files you can read and edit under the bot's Memory. after a week of small corrections like "shorter" or "skip newsletters", most people only glance at the drafts.