Connect your Gmail inbox

Let rct-keep scan Gmail for receipt emails automatically. This is the fastest setup path for a new account if your receipts already live in Gmail, and you can add more inboxes later if needed.

On this page

Before you start Connect Gmail What the first scan does After connecting If Gmail isn't the right fit

Before you start

  • You need an rct-keep account and an active subscription to connect inbox scanning.
  • Gmail inbox scanning uses Google OAuth and requests read-only Gmail access.
  • The first import looks back through the last 12 months for receipt-like emails.
  • You can connect more than one inbox from Settings if receipts are spread across accounts or providers.
  • If you do not use Gmail, use Connect an IMAP mailbox or Email forwarding setup instead.

Connect Gmail

  1. Sign in to rct-keep
    Create an account at /register or sign in at /login.
  2. Open Settings
    Go to Settings and find the Email Accounts section.
  3. Click Connect Gmail
    rct-keep redirects you to Google.
  4. Choose the Gmail account and approve access
    Google shows the permissions screen. Approve the read-only Gmail access request so rct-keep can scan for receipt emails.
  5. Return to Settings
    After the OAuth flow completes, rct-keep saves the connection and immediately starts the first inbox scan.
  6. Repeat for other inboxes if needed
    If some receipts live in another Gmail account or in Yahoo, iCloud, Fastmail, or another IMAP provider, you can add those from the same Settings page too.

What the first scan does

The initial scan searches Gmail for receipt-like emails from the last 12 months. Matching emails are queued for processing and the status panel in Settings updates as the import runs.

Imported
Messages that were successfully turned into receipts.
Skipped
Messages that were ignored because they were duplicates, did not qualify, or had already been processed.
Queued
Messages discovered and handed off for receipt processing.
Paused states
Large imports can pause temporarily if the hourly import limit or weekly quota is reached, then resume when capacity is available.
The first scan is paced automatically. If you have a large backlog of receipt emails, imports may continue in the background for a while instead of landing all at once.

After connecting

  • New receipt emails in Gmail are picked up automatically after the first import.
  • Imported receipts appear in your main Receipts list like any other receipt.
  • You can use Scan now in Settings to trigger another full scan manually.
  • You can keep this Gmail inbox connected alongside other Gmail or IMAP inboxes.
  • You can disconnect the Gmail account from Settings at any time.

Gmail inbox scanning complements manual upload and forwarding. If a receipt was never emailed, you can still upload it manually.

If Gmail isn't the right fit

Use Connect an IMAP mailbox if your receipts live in Yahoo, iCloud, Fastmail, or another IMAP provider. Use Email forwarding setup if you prefer to keep inbox access disconnected and forward only the messages you want rct-keep to process.