AtlasWork, planned itself.

    The AI-native, all-in-one work platform. Tasks, projects, CRM, contracts, and analytics in one calm workspace.

    System status
    • SSO
    • SCIM
    • Two-factor sign-in
    • Audit log

    Product

    • Overview
    • PDF tools
    • Diagram tools
    • People & HR
    • Integrations
    • Marketplace
    • Pricing

    Resources

    • Guides
    • Glossary
    • Compare
    • Docs
    • API reference
    • Support
    • Changelog
    • Status

    Company

    • About
    • Careers
    • Press
    • Contact

    Legal & trust

    • Trust center
    • Security
    • Privacy
    • Terms
    • DPA
    • GDPR
    • SLA
    • Refunds
    • Google API data
    Atlas, a product by wrxstack.com·© 2026 wrxstack·All rights reserved
    PrivacyTermsSecurityStatus

    You are in control of your cookies

    Atlas uses strictly necessary cookies to keep you signed in. With your consent, we add anonymized product analytics, conversion attribution, and remembered preferences. Change your mind any time at /privacy/cookies.

    Off until you agree · Change it any time

    • NecessaryAlways on
    • AnalyticsOpt-in
    • MarketingOpt-in
    • PreferencesOpt-in
    Still loading. Try again in a moment.Still loading. Try again in a moment.Still loading. Try again in a moment.
    Skip to documentation
    Docs
    Back to Atlas

    Start here

    • Overview

    Developer

    • REST API guide
    • Authentication
    • API reference
    • MCP (AI agents)
    • MCP tools reference
    • SDKs
    • Quick actions
    • Changelog

    Webhooks

    • Overview
    • Quickstart
    • Events
    • Payloads and headers
    • Security and signing
    • Delivery and retries
    • Managing via API

    Connect

    • Connectors
    • Integrations

    Product

    • Collaboration and chat
    • Signing in and security
    • Client portal
    • Client portal domains

    Reference

    • Glossary
    • Keyboard shortcuts
    • Module reference
    Gmail logo

    Email

    Gmail

    Pull threads, messages, and labels from a connected Gmail mailbox so you can triage email inside Atlas.

    AuthOAuth 2.0UpdatesReal-timeAvailable

    What this connector does

    • Pull individual mailbox threads, messages, and labels for the connected user.
    • Convert any thread into an Atlas task with the original email preserved as context.
    • Sync read state and starred state back to Gmail so the mailbox stays in sync.
    • Be told about new messages through Google push notifications, so triage runs in near real time.

    Before you begin

    • You are an owner or administrator of your Atlas workspace.
    • You can sign in to your Gmail account and approve access for Atlas.
    • Atlas looks after the Gmail app on its side, so there is nothing for you to create or copy.

    How to connect

    1

    Open Gmail in Integrations

    In Atlas, open Integrations and select Gmail.

    2

    Press Connect

    Atlas sends you to Gmail to sign in. Sign in with the account you want to connect.

    3

    Approve access

    Review the permissions that Gmail lists and approve them. Atlas returns you to the connector page, which then shows the connection.

    4

    Check the connection

    Select Test connection on the connector page. A passing result means Atlas can read from Gmail.

    Permissions Atlas asks for

    Read messageshttps://www.googleapis.com/auth/gmail.readonly
    Modify labels and read statehttps://www.googleapis.com/auth/gmail.modify
    Send email on your behalfhttps://www.googleapis.com/auth/gmail.send
    Account profileopenid email profile

    Setup checklist

    1. Confirm you are an owner or administrator of your Atlas workspace.
    2. Open Integrations and select the connector.
    3. Press Connect and sign in to Gmail.
    4. Review the permissions that Gmail lists and approve them.
    5. Select Test connection and read the result.

    Troubleshooting

    • Connect says Gmail is not available yet

      Atlas has not enabled Gmail for this deployment, so there is nothing for you to configure. Check again later.

    • The sign-in was cancelled

      If you close the Gmail screen or choose Cancel, Atlas does not connect. Press Connect again and approve the access.

    • Atlas asks you to reconnect

      Gmail can end a connection when access is revoked or a password changes. Press Reconnect on the connector page and approve the access again.

    Event notifications

    Gmail sends Atlas a push notification through Google Pub/Sub when the mailbox changes. Atlas verifies each notification and then reads the changed messages. If a notification is late, Atlas recovers the missed changes from the mailbox history.

    Events Atlas listens for

    • New message in INBOX
    • Label added or removed
    • Message marked read or starred

    Disconnect and data deletion

    1. Click Disconnect on the Atlas Gmail connector page to revoke the saved sign-in.
    2. Open https://myaccount.google.com/permissions and remove the Atlas app for the connected account.
    3. Atlas deletes the locally cached thread metadata for that user within 24 hours of disconnect.

    When you are ready, open the live connector page and press Connect to finish connecting Gmail.

    Open the Gmail connector page
    About this page

    On this page

    • What this connector does
    • Before you begin
    • How to connect
    • Permissions Atlas asks for
    • Setup checklist
    • Troubleshooting
    • Event notifications
    • Disconnect and data deletion

    Next steps

    • Open the Gmail connector page
    • All connector guides
    • Verifying webhook signatures