# Run agents with Gmail

Gmail AI agents on Rush: connect Gmail once, then name it on any run. Read, send and organise mail.

[Connect Gmail](https://cloud.getrush.ai/console/settings/?section=connections) in the console under Settings → Connections.

## What an agent can do in Gmail

Read, send and organise mail.

## Jobs on Rush that use Gmail

- [Turn Buyer Inquiries in Each Real Estate Agent's Gmail Into CRM Leads](https://getrush.ai/run/capture-buyer-inquiries/gmail/)
- [Where Are Last Month's Receipts? A Bookkeeping App Collects Each Freelancer's Emailed Receipts From Their Gmail](https://getrush.ai/run/collect-monthly-receipts-from-email/gmail/)
- [Draft Replies to Customer Order Questions in an Online Store's Gmail](https://getrush.ai/run/draft-replies-to-order-questions/gmail/)
- [Track Candidate Replies in Each Recruiter's Gmail From Your Recruiting Software](https://getrush.ai/run/track-candidate-replies/gmail/)

## Agents that use Gmail

- [Newsletter Drafter: A digest from your sources](https://getrush.ai/templates/newsletter-drafter-dfee2c84/)
- [Invoice Extractor: Invoices from mail to a sheet](https://getrush.ai/templates/invoice-extractor-bba5572f/)
- [Phishing Email Checker: Is this email safe?](https://getrush.ai/templates/phishing-email-checker-70dc9341/)
- [Receipt to Expense Log: Receipts into an expense sheet](https://getrush.ai/templates/receipt-to-expense-log-a51e75cc/)
- [Support Inbox Agent: Answers from your own docs](https://getrush.ai/templates/support-inbox-agent-098033ad/)
- [Inbox Triage: Label mail and draft replies](https://getrush.ai/templates/inbox-triage-fd712959/)
- [Follow-up Chaser: Nudge threads that went quiet](https://getrush.ai/templates/follow-up-chaser-0775258e/)
- [Cold Email Drafter: Researched first-touch drafts](https://getrush.ai/templates/cold-email-drafter-a297e041/)

## How Gmail connects

Gmail is a built-in app: you sign in with your Google account on its own page, through Rush's own app, so you register no OAuth app. The sign-in asks only for the scopes listed below, and the run's token reaches `gmail.googleapis.com`, the Gmail REST API.

Connect it once in the console under Settings → Connections, or from your server with `POST /me/connections`. The sign-in finishes in a browser signed in to the console as the same person, and a link not finished within 10 minutes expires.

After that, a run that names `gmail` in `connections`, or runs a saved agent that names it, gets it; your connections reach no run that does not name them.

Scopes the sign-in asks for:

- `https://www.googleapis.com/auth/userinfo.email`
- `https://www.googleapis.com/auth/gmail.readonly`
- `https://www.googleapis.com/auth/gmail.send`
- `https://www.googleapis.com/auth/gmail.modify`

```http
POST https://api.phoenix.so/me/connections

{
  "type": "app",
  "name": "gmail"
}
```

## Whose Gmail account the agent uses

Your Gmail connection is personal: it belongs to the person who signed in. A run started in the console uses that person's Gmail, and a run started with an API key uses the Gmail of the member who created the key.

To act for your own app's users, make each user an agent from your template and show them, signed in to your app, the sign-in link `POST /o/{org}/agents/{agent}/connections` returns. They sign in to their own Gmail, and that agent's runs use their account and nothing else: never yours, never another user's.

## More Productivity integrations

- [Google Calendar](https://getrush.ai/integrations/google-calendar/)
- [Google Drive](https://getrush.ai/integrations/google-drive/)
- [Outlook](https://getrush.ai/integrations/outlook/)
- [Microsoft Calendar](https://getrush.ai/integrations/microsoft-calendar/)
- [OneDrive](https://getrush.ai/integrations/onedrive/)
- [Notion](https://getrush.ai/integrations/notion/)
- [Airtable](https://getrush.ai/integrations/airtable/)

## Frequently asked questions

### How do I connect Gmail to Rush?

Open Settings → Connections in the console and connect Gmail, or send `POST /me/connections` with `{"type":"app","name":"gmail"}` and open the `authorize_url` it returns while signed in to the console. The connection reads `pending` until the sign-in finishes, then `connected`.

### Does every run get my Gmail account?

No. A run gets your Gmail connection only when it names it in `connections` (`"connections": ["gmail"]`), or runs a saved agent that names it. A saved agent names its connections once, and every run of it gets them.

### What can an agent do in Gmail?

Read, send and organise mail. 4 published jobs use it; this page lists them.

### Can an agent only read Gmail?

Yes. A saved agent can name Gmail with an access level: `read` asks for reading alone, and `send` adds sending. An agent made from it signs in, and every run of it is refreshed, for that level alone.

## Keep reading

- [AI agents for operations teams: every job and app for them](https://getrush.ai/solutions/operations/)
- [How connections work: sign in once, then every run that names a connection gets it](https://getrush.ai/docs/concepts/connections/)
- [Start your first run from the developer API quickstart](https://getrush.ai/docs/quickstart/)
- [Pricing: one price per member, hours shared by the team](https://getrush.ai/pricing/)
- [How Rush compares with other cloud agents](https://getrush.ai/compare/)
- [Every app and MCP server Rush connects to](https://getrush.ai/integrations/)
