Skip to content

Collaboration

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.

  1. In Dave, go to Integrations → Add integration → Gmail.

  2. Set a Label, e.g. support-inbox.

  3. Choose Connect Gmail and sign in to the mailbox Dave should read.

  4. 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.

Dave requests one OAuth scope:

https://www.googleapis.com/auth/gmail.readonly

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.

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.