Skip to main content

Connect Gmail

Connect Gmail, choose what to sync and confirm the mailbox is ready.

Written by Carl Martin

Connect your Gmail account so you can review email alongside tasks and give Scout Agent the context it needs. Connecting a mailbox and permitting Scout Agent to send are separate decisions.

Before you start

You need access to your Google account. A Google Workspace administrator may restrict third-party applications. Resolve an organization restriction with that administrator.

Email accounts connection options for Microsoft 365, Gmail and iCloud.

Connect your own provider account from Email accounts.

Connect and verify Gmail

  1. Open Settings → Email accounts and choose Connect Gmail.

  2. Follow the connection wizard and sign in to the intended Google account. Check the account address before granting the requested access.

  3. Return to Cartograph and confirm the mailbox appears under Connected accounts without a reconnect warning.

  4. Open the account settings. Review folders, import history and the sharing choices before broadening the imported context.

  5. Check the mailbox’s Scout permissions. Choose when Scout Agent must ask before sending on your behalf.

  6. Wait for sync, then find a known recent message in Inbox. Check the sender address when preparing a reply.

Check the result

The intended Gmail address is connected and recent email is visible. Initial history can take longer to import than new messages; a connected badge alone does not prove every older message has arrived.

Privacy and sending

Messages remain private to you until you share them. Review Email you have shared to inspect existing grants and take access back when appropriate.

The default account controls new threads started by Scout Agent. Replies to an existing thread stay on its existing address. Check both the default and the actual draft sender.

Folders and history

Inbox and Sent are required for incoming and outgoing context. Gmail labels can apply to the same message; removing a label has different effects from deleting mail. Read the confirmation before folder operations.

If something does not look right

What you see

What to check

Google blocks consent

Ask the Google Workspace administrator whether Cartograph is allowed for your account.

Older messages are missing

Check Import history, selected folders and sync state before reconnecting.

Does connecting let everyone read my Gmail?

Connecting your personal mailbox does not automatically share all of its messages with the workspace. Sharing controls decide which content others can access.

Continue your work

Open the relevant area in Cartograph to continue with your workspace data.

Related articles

Did this answer your question?