Skip to main content
Connect Gmail to browse and query your emails as files.

​
Connect

airstore connect gmail
OAuth in your browser. Grant read access to your Gmail account.

​
What appears

~/airstore/sources/gmail/
├── inbox/
│   ├── 001-meeting-invite.eml
│   ├── 002-project-update.eml
│   └── ...
├── sent/
├── drafts/
└── [your smart folders]
Emails are stored as .eml files, a standard format that includes headers, body, and attachments.

​
Example queries

# Emails from a specific sender
airstore create sources/gmail/from-ceo \
  --query "emails from [email protected]"

# Recent important emails
airstore create sources/gmail/urgent \
  --query "unread emails marked important from the last week"

# Emails with attachments
airstore create sources/gmail/with-files \
  --query "emails with PDF attachments from the last 30 days"

# Search by subject
airstore create sources/gmail/invoices \
  --query "emails with 'invoice' in the subject"

# Combine filters
airstore create sources/gmail/investor-updates \
  --query "emails from investors containing 'update' in the last 60 days"

​
File format

Each email is a .eml file: 
From: [email protected]
To: [email protected]
Subject: Q4 Update
Date: Mon, 15 Jan 2024 10:30:00 -0800
Content-Type: text/plain

Email body here...
Claude Code can read these files directly and understand the email content, headers, and context.

​
Supported query filters

FilterExample
Sender”emails from [email protected]”
Recipient”emails to [email protected]”
Subject”emails with ‘invoice’ in subject”
Date range”emails from the last 30 days”
Labels”emails labeled ‘important‘“
Read status”unread emails”
Attachments”emails with attachments”
Attachment type”emails with PDF attachments”

​
Limitations

  • Read-only: Gmail source is read-only. Use the Gmail tool to send or modify emails.
  • Attachment size: Large attachments (>25MB) may be truncated.
  • Rate limits: Airstore handles Gmail API rate limits automatically.

​
Example workflow

Summarize investor communications: 
# Create a smart folder
airstore create sources/gmail/investor-emails \
  --query "emails from investors in the last 30 days"

# Mount and use with Claude
airstore mount ~/airstore
cd ~/airstore/sources/gmail/investor-emails
claude "Summarize these investor emails and draft a status update"

​
Next steps

Google Drive

Connect your documents.

Smart folders

Learn more about queries.