send a gmail email by telling your bot what to say

get the payroll email ready without assembling it again every friday. a bot can send through your connected gmail, with cc, bcc, attachments and your signature.

by the dusk bot team · checked 12 november 2026 · how we made this

give at least one address and a subject or body. sends ask first by default unless you set a daily amount. review the recipients as carefully as the words before tapping allow.

pixel art: an indigo pixel bot, a sky blue pixel bot and a green pixel bot beside the Gmail mark on a white tile, a mailbox with a letter and a wrapped parcel, on a sandy path in front of a calm sea with one small island, one saying "payroll email ready"

where it helps

supplier details: send the delivery address you just confirmed.
signed paperwork: send your attached order form, copying only the buyer you name.
an announcement: send the text you approved to your chosen list.
travel notes: email yourself the instructions you gave the bot.

the short version

this writes and sends in one step. give the bot at least one email address, plus a subject or body. a first name alone isn't an address.

plain text or formatted email
extra recipients, cc and bcc if you name them
your gmail signature, when the connection can read it
attachments totalling no more than 20 mb

still choosing the words? ask to see them in chat first.

step by step

choose the account. connect gmail with read and write; read only cannot send.
set the sending rule. choose ask every time. give the exact addresses and source material.
send yourself a test. read to, cc and bcc, then the wording and file list before allow.
then repeat it. add the friday instruction and read the time on the schedule card.

send this to your bot

paste this into a chat with your bot

every friday at 4, read this week's entries in the hours tab of my payroll sheet. add the hours from monday onwards. show me an email to [email protected] with the daily figures and total. wait for my allow before sending from work gmail. if the sheet has no entries, stay quiet. never add recipients or guess missing hours.

when: fridays at 16:00
needs: work gmail read and write; google sheets access for reading the hours tab; sending set to ask every time

what comes back looks like this (an example)

ready for your allow

to: [email protected]
subject: hours, week of 9 november

31.5 hours this week
- monday: 7.5
- tuesday: 8
- wednesday: 8
- thursday: 8

what can go wrong

careful with Full access: a bot there with no sending rule can send up to 25 a day without asking. give it Ask every time.
the from address must be yours. use the connected address or an alias already set up under gmail's send mail as.
your signature might be missing. it needs a saved signature and permission to read it. inspect the sign-off.
20 mb is the total attachment limit. add the file sizes together, rather than judging each alone.

permissions and asking first

dusk bot counts Send Email as a send: it reaches people or moves money, so it waits for your Allow (unless you set a daily amount, or the bot is on Full access with no sending rule, which lets it send up to 25 a day). a bot you allow only to read can never call it.

the permissions Gmail asks for to run it: https://mail.google.com/, gmail.modify, gmail.compose, gmail.send.

inputs

input	required	what it is
`cc`	no	Carbon Copy (CC) recipients' email addresses.
`bcc`	no	Blind Carbon Copy (BCC) recipients' email addresses.
`body`	no	Email content (plain text or HTML).
`is_html`	no	Set to `True` if the email body contains HTML tags.
`subject`	no	Subject line of the email.
`attachment`	no	File(s) to attach.

from composio's catalog for Gmail (action GMAIL_SEND_EMAIL, read 12 november 2026⁴). your bot fills these in from what you tell it.

try it in 2 minutes

set gmail sending to ask every time
ask for a two-line test email to yourself
read the address and attached filenames
tap allow and open the email in your inbox

quick checklist

the outgoing account is right
to, cc and bcc contain only the intended people
attachments are correct and within 20 mb
the signature looks right

mistakes people make

saying "send it to alex"

give the exact email address, especially when names overlap.

forgetting the saved signature

ask to see the sign-off with the body; the connection needs permission to read it.

reading the body but skipping cc

read to, cc and bcc separately before allow.

questions

can i send to more than one person?

yes. name each group. give the main recipient, extra recipients, cc and bcc. ask to see them separately before allow.

will this keep an email waiting in drafts?

no. it sends now. use create email draft if you want to finish and send it in gmail yourself.

sources

dusk bot docs: files and apps
dusk bot docs: routines
dusk bot docs: a bot's computer
composio, Gmail toolkit (catalog version 20261105_00), checked 12 november 2026

drafted with ai help from the dusk bot docs and the sources listed on this page, then checked against them. if something here is wrong or out of date, write to [email protected].