Collaboration
Gmail
Connect one Gmail mailbox so Dave can search it and read messages and attachments, read-only.
Each connection is one mailbox. Dave can search it, read messages and download attachments. It cannot send, delete, label or change mail. To give Dave several mailboxes, add one connection per mailbox.
Connect
Section titled “Connect”-
In Dave, go to Integrations → Add integration → Gmail.
-
Set a Label, e.g.
support-inbox. -
Choose Connect Gmail and sign in to the mailbox Dave should read.
-
On Google’s consent screen, allow reading your email. Dave refuses the connection if it is left unticked.
The connection’s details show which mailbox it reads.
Permissions
Section titled “Permissions”Dave requests one OAuth scope:
https://www.googleapis.com/auth/gmail.readonlyManage the connection
Section titled “Manage the connection”Disconnect in Dave revokes the grant at Google. You can also revoke it yourself: signed in to the mailbox, Google Account → Security → Your connections to third-party apps & services → Dave → Delete all connections. The connection then fails its health check until you connect again.
Troubleshooting
Section titled “Troubleshooting”When the connection fails, the row shows one of these reasons:
| Reason | Meaning |
|---|---|
missing_gmail_scope |
Reading email was unticked on Google’s consent screen. Connect again. |
mailbox_mismatch |
A reconnect signed in to a different mailbox. Sign in to the original one, or add a new connection. |
missing_refresh_token |
Google did not return a long-lived token. Connect again. |
If the sign-in fails with an administrator policy error, your Workspace domain restricts third-party apps. An admin can trust the OAuth client ID your Dave contact gives you under Security → Access and data control → API controls → Manage Third-Party App Access.