CognitiveUX AI
    GMAIL INTEGRATION

    CognitiveUX AI for Gmail

    CognitiveUX AI is an AI teammate for performance marketing teams. The Gmail integration reads the emails that match filters you set, so your own AI agents and workflows can use them as context for your marketing analysis. Access is read-only.

    Last updated: September 30, 2026

    What it does

    Reads the emails you choose

    Emails that match a workspace’s filters become context for your own AI agents and workflows — nothing else in the mailbox is read.

    Read-only

    The app never sends, changes or deletes email.

    Scoped per workspace

    Each CognitiveUX AI workspace sets its own filters, and stored copies are kept separate per account and workspace.

    Who can use it

    • Teams with a CognitiveUX AI account and a Google account with Gmail.
    • Only an account manager can connect Gmail, set filters or change these settings.

    How to connect

    Connecting starts inside the CognitiveUX AI dashboard, because the connection belongs to a signed-in account.

    1. 1

      Sign in to CognitiveUX AI

      Sign in to the CognitiveUX AI dashboard (shown as Almond) at poc.cognitiveux.ai. No account yet? Start a free trial first.

    2. 2

      Connect Gmail

      Go to Settings → Integrations, find 4. Integrate Gmail and click Sign In. Google asks you to choose an account and approve read-only access to Gmail — approve it and you are sent back to the dashboard.

    3. 3

      Choose which emails a workspace reads

      In Workspace Settings → Preferences → Integrations → Gmail, switch Gmail on for the workspace and set its filters:

      • sender address or domain, and recipient
      • words in the subject or body, and words to exclude
      • labels
      • with or without attachments
      • newer than a set number of days

      Nothing is read until Gmail is switched on for the workspace and saved.

    4. 4

      Preview and sync

      Click Preview Results to see what your filters match, set the sync schedule, and click Sync now if you want the first copy straight away.

    Permissions requested

    The integration asks Google for one scope, and it is read-only.

    • https://www.googleapis.com/auth/gmail.readonlyRead-only. Used to read the emails, and their attachments, that match the workspace’s filters. The app never sends, changes or deletes email.

    Your data

    What is read

    • Only emails that match the workspace’s filters: their headers and body.
    • The attachments of those emails.
    • When Gmail is first switched on, past emails are copied once: the filter’s own time window if it has one, otherwise the last 90 days. After that, new matching emails are copied on the workspace’s schedule or when you click Sync now.

    What is stored

    • One PDF per day of matching emails, plus a text copy.
    • Attachments are kept as separate files in their own format.
    • Copies are kept in private cloud storage, separated per account and workspace. The Google token is stored server-side and never sent to the browser.
    • Copies are deleted after the workspace’s retention period, counted from when each was copied: 90 days by default, configurable from 1 to 3650 days under Data Retention. Information already added to the workspace’s memory may be kept after the original copy is deleted.
    • When one of your agents uses this content, it is sent to the AI model provider that runs the agent. It is not used to train generalized AI models.

    How to disconnect and remove it

    • To stop reading for one workspace, switch Gmail off in Workspace Settings → Preferences → Integrations → Gmail.
    • To disconnect, click Sign Out on 4. Integrate Gmail in Settings → Integrations. This deletes our stored token and stops further reading.
    • Gmail, Google Drive and our Google Ads connection share one Google sign-in, so Sign Out does not revoke the Google grant (that would also disconnect Google Ads). To revoke it fully, remove our app’s access at myaccount.google.com/permissions; this also disconnects Google Ads.
    • Copies already stored stay until the retention period ends or you ask us to delete them; deleting a workspace deletes its synced copies. To have them deleted sooner, email [email protected] with the subject “Data Deletion Request”.

    Questions or a deletion request? Email [email protected] — no account needed. See also the other connected apps: Slack, Gmail, Google Drive.