Gmail and Google Workspace
Connect Gmail or a Google Workspace mailbox with a Google app password, step by step, including 2-Step Verification and fixes when Google blocks it.
Connect your Gmail or Google Workspace (work or school) mailbox so your AI can search, read and draft your email, and send when you allow it. Gmail connects with a Google app password: a 16-letter password Google creates only for Plugsight. It takes about two minutes.
What your AI can do
- Search your whole mailbox live, including with Gmail search syntax such as
from:amazon newer_than:7d. - Read full emails, conversations and attachments (PDF, Word, Excel and PowerPoint are read as text).
- Save drafts, replies and forwards to your Gmail Drafts.
- Send email, once you switch sending on and approve each email in the chat.
- Archive, label, star and mark emails read or unread. Gmail is the only email connection that supports labels added through Plugsight.
Try asking:
- "Find every invoice we received from suppliers this quarter and list the totals."
- "Summarise my unread email from customers today."
- "Draft a reply to the latest email from Acme about the delayed order."
- "Archive every newsletter in my inbox and label the receipts 'Expenses'."
- "What did the contract PDF attached to Sarah's email say about payment terms?"
See What your AI can do with email for every action in detail.
What you need
- A Gmail address, or a Google Workspace address whose mail is in Gmail.
- 2-Step Verification turned on for that Google account. Google only offers app passwords when it is on.
- For a work or school account: your administrator must allow app passwords.
Connect Gmail
- In app.plugsight.app, go to Connections and click Add connection.
- Click the Gmail / Google Workspace tile. (Or type your address in the detect box: Gmail addresses go to this same page.)
- Type your address in Gmail address. Do this first: the buttons in the next steps then open that exact Google account.
- Follow the steps on the page, described below.
- Paste the app password into App password and click Test connection & save.
The page shows the server settings it uses (imap.gmail.com:993 and smtp.gmail.com:465), so there's nothing to fill in.
Step 1: Turn on 2-Step Verification (skip if it's already on)
- Click Open 2-Step Verification ↗. Google's 2-Step Verification page opens in a new tab.
- If you see a blue Turn on 2-Step Verification button, add your Phone number first.
- Then click Turn on 2-Step Verification.
Step 2: Create an app password
- Click Open App passwords ↗. Google's App passwords page opens.
- Type Plugsight as the name.
- Click Create. Google shows a 16-letter password.
Step 3: Copy it
Google shows the password only once. Copy it before you close that tab.
If you close Google's tab before copying the password, you can't see it again. Create a new one the same way.
Step 4: Paste it and click Test connection & save
Paste the password into App password in Plugsight. Spaces are fine: Plugsight removes them. Plugsight signs in to check the password works before saving anything. Your normal Google password stays private.
If you're signed in to several Google accounts
Google opens its pages in whichever account your browser uses first, which may not be the one you're connecting. Plugsight's buttons add your address to the link (Google's authuser setting), so they open the account you typed in Gmail address.
- If you haven't typed the address yet, the page says Type your Gmail address above first, so these links open the right Google account.
- Once you have, it says the links open that address. Before creating the password, check that the photo at the top right of Google's page shows the right account.
What it can and can't change
New connections start on Drafts only: your AI can read and write drafts, but can't send. To let it send:
- On Connections, click the account's switch so it says Can send. This needs the Pro or Agency plan.
- Check the line under the switch says Ready.
Every email still needs your yes in the chat before it goes. Archiving, labelling and marking emails don't need the switch, but do need a plan that includes changes. See Sending, drafts and the daily email limit.
Limits
- Your AI can send up to 20 emails per account in any 24 hours by default (you can choose 1 to 500). Drafts don't count.
- Gmail has its own limit of about 500 emails a day. Google Workspace allows more.
- Attachments you send can total up to 20 MB per email.
Troubleshooting
Google says "The setting you are looking for is not available for your account"
What it means: Google is hiding the App passwords page from this account. There are four possible reasons.
How to fix it: check them in this order.
- 2-Step Verification is off. Turn it on (step 1 above), then open App passwords again.
- 2-Step Verification uses only passkeys or security keys. Add a phone number or an authenticator app on the 2-Step Verification page, then try again.
- It's a work or school account (Google Workspace). Your administrator has turned app passwords off. Ask them to allow 2-Step Verification and app passwords in the Google Admin console.
- Advanced Protection is on. Google doesn't allow app passwords on these accounts, so this account can't be connected with an app password.
Could not connect: … Check the password; most providers need an app password, not your normal one.
What it means: Google refused the sign-in. Usually the password is your normal Google password, was mistyped, or the app password was deleted.
How to fix it: create a new app password (step 2) and paste it. Check the address in Gmail address is the same account you created the password in.
The App passwords page opened a different Google account
What it means: your browser is signed in to several Google accounts.
How to fix it: type your address in Gmail address before clicking Open App passwords ↗, and check the photo at the top right of Google's page. See If you're signed in to several Google accounts.
The connection says it needs reconnecting: "The mail server rejected the password; it may have been changed or revoked."
What it means: Google no longer accepts the app password, usually because it was deleted or your Google account's sign-in settings changed. Your AI can't use the account until you reconnect it.
How to fix it: on Connections, click Reconnect. The Gmail page opens with your address filled in. Create a new app password and click Test connection & save. Your settings and MCP servers stay as they were.
Labels are a Gmail feature. For this mailbox, move the email to a folder instead (move_to).
What it means: your AI tried to add a label to a mailbox that isn't Gmail. You won't see this on a Gmail connection; it means the AI picked a different account.
How to fix it: tell your AI which account to use, for example "in my work Gmail".