Connectors
Gmail & Google Calendar
Gmail and Google Calendar are connected as separate connectors, each with its own OAuth sign-in and permissions. Together they let Grok manage your email and schedule from within a conversation.
Gmail
Capabilities
- Search emails using Gmail search operators (
from:,to:,subject:,newer_than:,has:attachment, etc.). - Read full messages including body text, headers, and attachments.
- Compose and manage drafts so you can review before sending.
- Send messages, reply, and forward when write permissions are enabled.
- Organize mail by modifying labels, creating labels, trashing, or deleting messages.
Required permissions
Gmail uses a tiered permission model. The base connection is read-only; write and send capabilities are enabled progressively by your organization's administrators.
| Scope | Purpose | When requested |
|---|---|---|
gmail.readonly | Search and read emails | Always (base) |
gmail.modify | Drafts, trash, label changes | When write tools are enabled |
gmail.send | Send messages, reply, forward | When send tools are enabled |
gmail.labels | Create and delete labels | When label management tools are enabled |
userinfo.email | Identify your Google account | Always |
Note: gmail.modify is a superset of gmail.readonly. When write tools are enabled, only the modify scope is requested to avoid duplicate permission prompts.
How to connect
- Go to grok.com/connectors.
- Click New Connector and select Gmail.
- Sign in with your Google account and approve the requested permissions.
Google Calendar
Capabilities
- Search events by date range and keyword.
- View event details including attendees, location, and description.
- Check availability with free/busy lookups.
- Create, update, and delete events when write permissions are enabled.
- RSVP to events (accept, decline, tentative).
- List calendars the account has access to.
Required permissions
Like Gmail, Google Calendar uses a tiered permission model.
| Scope | Purpose | When requested |
|---|---|---|
calendar.readonly | Search and read calendar events | Always (base) |
calendar.events | Create, update, and delete events | When write tools are enabled |
calendar.freebusy | Check availability / free-busy status | When availability tool is enabled |
calendar.calendarlist.readonly | List accessible calendars | When calendar list tool is enabled |
userinfo.email | Identify your Google account | Always |
How to connect
- Go to grok.com/connectors.
- Click New Connector and select Google Calendar.
- Sign in with your Google account and approve the requested permissions.
Privacy and security
We do not train on your data. xAI does not use your Gmail or Google Calendar data for model training.
Nothing is stored. Conversations that use your Google connectors do not result in any of your email or calendar data being stored on xAI servers. Grok accesses your data in real time when you ask a question, and does not retain it afterward.
You control access. Disconnect at any time to immediately revoke Grok's access to your Google account.
Disconnecting
To disconnect either connector:
- Go to grok.com/connectors.
- Find the connector and click Disconnect.
You can also revoke the app's access from your Google account at myaccount.google.com/permissions.
Did you find this page helpful?
Last updated: May 5, 2026