Gmail Connector
The Gmail connector imports messages that match selected Gmail labels. Use it to build a searchable Store from focused mailboxes such as support, partnerships, customer feedback, or project correspondence.
Before you beginLink to section
You need a Google account with access to the Gmail mailbox and a Mixedbread organization with access to Data sources.
Connect GmailLink to section
In the Mixedbread Platform, open Data sources, select Create, and choose Gmail.
Enter an optional Store name and review the Store configuration. Leave the
name blank to use gmail-{your - account}.
Select Connect Gmail, choose the Google account that owns the mailbox, and approve the requested access.
Back in Mixedbread, select the system or custom labels whose matching messages should be synchronized.
Saving the label selection starts the initial message import. Mixedbread keeps messages matching the selected labels up to date.
Choose labelsLink to section
The connector shows useful system labels, including Inbox, Important, Sent, and Starred, alongside your custom labels. Select only the labels needed for the Store to avoid importing unrelated mail.
Manage the connectorLink to section
Open the Gmail data source to:
- search available labels;
- synchronize or exclude labels;
- compare total and unread message counts;
- run Sync now to re-check selected labels; or
- disconnect Gmail.
Excluding a label stops future synchronization for that selection. Disconnecting removes the saved Gmail credentials. Previously imported Store files remain available.
TroubleshootingLink to section
Gmail needs to be reconnectedLink to section
Google credentials can expire or be revoked. Select Reconnect Gmail and authorize the same Google account to resume synchronization into the existing Store.
A label is missingLink to section
Confirm that the label still exists in Gmail, then reload the connector page. Some Gmail category and state labels are intentionally hidden because they are not useful connector selections.
Messages have not appearedLink to section
Verify that they match at least one selected label, then run Sync now.