How do I connect Grok Bot to Gmail?
Open Connect apps in the Grok Bot sidebar, add the Gmail plugin and authorize your Google account in the browser. Once it shows under Installed, it is connected. One Gmail plugin connects one mailbox at a time.
- Open Connect apps in the sidebar (on mobile: avatar → Connect apps), or follow an in-chat Connect card.
- Search for Gmail and add it.
- When asked to Authorize or Authenticate, sign in and approve in the browser.
- Back in Grok Bot, confirm Gmail is under Installed. Needs auth or Disconnected means installed but not signed in; authorize again.
What it can do
Section titled “What it can do”Per the Cursor Help Center: search and read mail, draft and send, and apply labels. A plugin can only do what your Google account can already do; it cannot change sharing or raise access.
Recommended permissions
Section titled “Recommended permissions”- In the plugin tool toggles, turn off send, reply and forward and keep read, drafts and labels (the Wright Mode setup). This is more reliable than writing “do not send” in a prompt.
- Keep it to drafts for the first week. Drafts appear as a card with Send email or Discard.
- Set deleting, unsubscribing and clicking links in emails to Ask first in Auto Review.
If it will not connect
Section titled “If it will not connect”- Sign-in did not finish: choose Reconnect (or Reopen on the chat card) and authorize with the right Google account.
- Company Google Workspace: an admin may need to approve the app named Grok first. Switching browsers or relinking will not get around it.
- Marketplace disabled by your team admin: it shows Disabled by team admin.
- Access revoked on the Google side: remove the plugin and add it again.
Related questions
Section titled “Related questions”Can Grok Bot connect to more than one Gmail account?
Section titled “Can Grok Bot connect to more than one Gmail account?”One Gmail plugin connects one mailbox at a time. The Help Center notes some plugins can connect a second account; check the plugin detail page.
Will Grok Bot send emails on its own?
Section titled “Will Grok Bot send emails on its own?”If the plugin has send permission, it may send when a task calls for it. Turn off send, reply and forward in the plugin toggles and keep it to drafts.
What if Gmail says an admin must approve the app?
Section titled “What if Gmail says an admin must approve the app?”Your Google Workspace admin has to approve the app named Grok first. Switching browsers or relinking will not bypass it.
Read next
Section titled “Read next”Continue with a complete tutorial
Browse all 25 complete tutorials →Start with original practice inputs, follow the staged prompts, then compare the complete reference results and acceptance checks. Each tutorial states what was tested and what still needs validation.
- Gmail inbox organization: labels, drafts and a daily brief8 synthetic emails, 6 labels plus Review, a classification table, reply drafts and a daily brief with staged acceptance.5 stages · 7 prompts · 5 files
- Invoice and receipt organization: deduplication and currency totalsUse eight synthetic text extracts to practice month boundaries, duplicate identity, missing amounts and separate currency totals before connecting email or spreadsheets.6 stages · 6 prompts · 6 files
References are listed below, but no documentation review date is recorded: unverified. If the interface looks different, send feedback or edit the page.Send feedbackEdit this page