With the Gmail module, Nema Crew agents work in your Gmail mailbox: they read and search emails, summarise, draft replies, sort with labels and react to new emails. The module works with personal Gmail accounts and with Google Workspace.
The connection uses the standard email protocols IMAP and SMTP directly at Google (imap.gmail.com, smtp.gmail.com). You connect the module with your email address and an app password. Nema never needs or sees your regular Google password.
Connect
- Turn on 2-Step Verification if you have not already: myaccount.google.com/signinoptions/twosv. Without it, Google does not offer app passwords.
- Create an app password: open myaccount.google.com/apppasswords, enter "Nema Crew" as the name and tap "Create".
- Google shows a password of 16 characters (in groups of four). In Nema Crew, go to Settings → Modules → Gmail and paste your email address and this password. Spaces do not matter.
- Save and test. Nema signs in to IMAP and SMTP once and shows whether it worked.
Google Workspace: your admin has to allow app passwords (Security → 2-Step Verification) and IMAP access (Apps → Gmail → End User Access) in the Admin console. Otherwise Google rejects the sign-in.
If the test fails
| Message | What to do |
|---|---|
| Wrong app password | Check the address, create a new app password at myaccount.google.com/apppasswords and enter it again. |
| Regular Google password | The app password goes here, not the password of your Google account. |
| IMAP is disabled | With Google Workspace, the admin has to allow IMAP. For personal accounts IMAP is always on today; if Gmail still shows the setting, it is under Settings → Forwarding and POP/IMAP. |
| Confirmation in the browser | Sign in at mail.google.com once, confirm Google's prompt, then test again. |
What agents can do
- Read: list emails in the inbox, Sent, Drafts, your own labels and All Mail; read single emails with their text and the list of attachments (name, type, size); look at whole conversations. The module does not download attachments themselves.
- Search with Gmail search, exactly like the Gmail search box:
from:anna@example.com has:attachment newer_than:7d. - Draft: create drafts and reply drafts in the Drafts folder. Nothing is sent; you review and send in Gmail.
- Send and reply: the agent first shows a preview with recipients, subject and text. It only sends once you agree. Gmail keeps sent emails in Sent as usual.
- Organise: mark as read or unread, archive, add and remove labels (missing ones are created), move to spam or to the trash (trash only after asking).
Trigger "New email"
If an agent listens to "New email", Nema Crew checks the inbox every five minutes. Each new email starts the agent once. It reports emails that arrive after the trigger was turned on. The module changes nothing in the mailbox while doing so, not even the read status.
Privacy
Nema stores the credentials encrypted. The module does not store content from Gmail; it fetches it again for every task. For the trigger, Nema only remembers up to which email it has checked and the ids of reported emails. Details: privacy notice for the Gmail module.
Disconnect
In Nema Crew under Settings → Modules → Gmail → Disconnect. Nema then deletes the stored credentials. You revoke the app password itself at Google under myaccount.google.com/apppasswords: delete "Nema Crew" there. After that, nobody can sign in with it any more.
Questions and problems: support@nema.im.
Changes
- 2.0 · 27 October 2026 – Connection with email address and app password over IMAP and SMTP, without a Google API. New: search in Gmail syntax, conversations, archiving and moving, reply drafts, sending only after a preview. Existing connections have to be set up again once.