Skip to main content
The Gmail integration (tagged Track Spend) scans your inbox for billing-related emails, downloads attachments, and turns them into documents ClearSpend parses for subscriptions, amounts, and renewal dates. Connect from Integrations on the Gmail card.
Gmail vs Google Drive. Gmail imports from your inbox (invoice emails and attachments). Google Drive imports PDF files from a Drive folder you choose. Connect both if invoices arrive by email and by shared drive.

​
What you get

ClearSpend requests read-only Gmail access. It reads message metadata and downloads attachments for processing; it does not send email on your behalf.

​
Who can connect

Owners and Admins can connect and disconnect Gmail. Members and Viewers cannot start a new OAuth connection. See Roles and permissions.

​
Connect Gmail

1

Open Integrations

Navigate to Integrations in the sidebar.
2

Find Gmail

Locate the Gmail card under Track Spend.
3

Click Connect

Click Connect. You are redirected to Google’s OAuth consent screen.
4

Choose the inbox

Sign in with the Google account whose inbox receives billing email (your own mailbox, a shared billing inbox, or a finance alias — whichever holds the invoices you want imported).
5

Approve read-only scopes

Approve the requested permissions. ClearSpend uses read-only Gmail scopes to list and download invoice attachments. You can revoke access later from your Google account or from Integrations.
6

Wait for the first sync

After authorization, ClearSpend redirects you back to Integrations. A first sync starts automatically. Most inboxes finish within a couple of minutes; large mailboxes with many historical invoices can take longer. The card shows last sync when a pass completes.

​
How Gmail sync works

On each sync, ClearSpend:
  1. Searches your inbox for emails that look like billing mail — typically messages with attachments whose subjects mention terms such as invoice, receipt, statement, payment, or bill.
  2. Skips already-processed messages so the same attachment is not imported twice.
  3. Downloads attachments (PDFs and other supported formats) and uploads them for parsing.
  4. Creates document rows that flow into subscription matching and spend totals.
The first sync looks back roughly 180 days unless a narrower window is configured for your workspace. Later syncs pick up new mail since the previous run.
Use Processing rules if you need to exclude specific senders or subjects from auto-import across integrations.
You can connect more than one Gmail account to the same workspace — useful when invoices are split across personal mailboxes, shared billing inboxes, or different Google accounts. Each connection appears as its own row when you expand the Gmail card on Integrations. Repeat the connect steps for each account that receives SaaS billing email.

​
Connected state

When Gmail is active, the card shows a green status indicator, how many accounts are linked, and the last sync time. Expand the card to see each linked inbox, sync status, and actions for that connection.

​
Gmail vs other upload paths

​
Common questions

Discovery happens in two waves. Integrations like Google Workspace surface apps within minutes. Vendors that only appear in invoice email are added as those messages are parsed — usually within an hour or two of connecting Gmail. If something is still missing after a day, upload an invoice manually to seed it.
ClearSpend focuses on messages with attachments that match billing-related keywords in the subject. Emails without attachments, sent mail, and drafts are skipped.
Yes. Access is read-only, tokens are encrypted, and you can disconnect from Integrations at any time.

​
Disconnect

Return to Integrations, expand the Gmail card, and disconnect the account you no longer want synced. Documents already imported stay in your workspace.