Guide

Grok Connectors Explained: What They Are and How to Add Them

Gmail
Google Drive
Google Calendar
Outlook
Microsoft Teams
SharePoint
Notion
Canva
Box
Linear
GitHub
Salesforce
Grok Bot
Grok Bot ↔ your apps

New to Grok Bot?

Get two weeks free on us.

Get Grok Bot

Short answer

Grok Bot connectors let Grok Bot read and act on your Gmail, Drive, Notion and more.

  • Ask about email and events
  • Find and use your files
  • You approve each sign-in
  • Admins control work accounts

What Are Grok Connectors?

Connect a service at grok.com/connectors, then ask about its files, messages or events. Connectors are available to all Grok users, and Grok uses the right one automatically or asks you to connect it in chat.

KindHow it works
Built-inxAI maintains the integration; sign in through OAuth (a standard account sign-in screen).
CatalogChoose a pre-configured service and sign in through OAuth.
Custom MCPGive Grok a public server URL and complete any required authentication; Grok discovers its tools.

Which Services Can I Connect?

Built-in services include Gmail, Google Calendar, Google Drive, OneDrive, Outlook Mail, Outlook Calendar, Microsoft Teams, SharePoint and Salesforce. Mail and calendar services have separate sign-ins and permissions. See the connector catalog.

Catalog exampleInformation it connects
Box and NotionFiles and folders; pages, databases and workspaces
GitHub and LinearRepositories, issues, pull requests and code; issues, projects and roadmaps
Canva and GammaDesigns and presentations; presentations and documents
S&P Global and VercelFinancial and company information; projects, deployments and logs
MeltwaterMedia and social intelligence; an active Meltwater subscription is required

SharePoint and OneDrive require Grok Business or Enterprise.

How Do I Add a Connector?

  1. On the web, open Grok connectors.

    grok.com/connectors page with the heading Supercharge Grok with Connectors and a Get Started button
    Start at grok.com/connectors. Sign in, then choose a service.
  2. Select New Connector and choose the service.

  3. Sign in to the service and approve the requested permissions.

  4. Ask Grok a question about the connected service.

For Drive, review consent and choose Allow. For Teams, use a Microsoft work or school account and choose Accept.

Other ways in:

  • In a chat on the web: + → Connectors → + Add connector.
  • On iOS or Android: Settings → Connectors.
  • Sign-in expired: choose Reconnect. The X connector shows your handle and offers Relink.
  • Automations: type @ to mention a connector. Add Trigger lists triggers only for connectors you can use.
  • Money questions: connect financial accounts under Connectors, then ask with @Finance.

What Can Mail and Calendars Do?

Gmail starts with read-only access; administrators can enable additional tools progressively.

  • Gmail searches accept operators such as from:, subject:, newer_than: and has:attachment.
  • Google Calendar can search by date and keyword, check free/busy availability, list accessible calendars and RSVP. With write tools enabled, it can create, update and delete events.
  • Outlook permissions apply to the signed-in user’s mailbox and calendar.
More detail: Gmail permissions and Outlook
Gmail permissionWhat it allows
gmail.readonlySearch and read messages, including bodies, headers and attachments.
gmail.modifyManage drafts, labels and trash; replaces the read-only scope when write tools are enabled.
gmail.sendSend messages, replies and forwards when send tools are enabled.
gmail.labelsCreate and delete labels when label management is enabled.

Outlook Mail can manage drafts with To, Cc, Bcc and HTML, attach Grok-generated files, send and organize messages. Outlook Calendar can check availability across attendees and create or update events with recurrence and reminders.

How Do File Connectors Work?

Google Drive searches by content or title across Docs, Sheets, Slides and other files. It reads content, creates documents and folders, trashes files and uploads generated artifacts.

Write access is optional; the signed-in account determines access. Filter results for starred or shared files, modification date or folder.

ServiceWhat Grok can do
OneDriveBrowse nested folders and upload generated files; access is limited to the signed-in user’s OneDrive.
SharePointSearch documents across accessible sites, read files and browse libraries. Connect it for full-text search of OneDrive for Business files.
Microsoft TeamsSearch chats and channels, read threads and reactions, send messages, create chats and browse membership within the user’s access.
SalesforceSearch objects and records, create leads or cases, and update records under the user’s profile, sharing rules and field-level security.
More detail: Salesforce setup

Salesforce supports one organization or instance per team. An admin provides OAuth credentials and installs and configures the Salesforce DX MCP Server before members connect.

How Do Admins Manage Connectors?

For Business or Enterprise, an admin provisions each connector before members connect. Adding or removing connectors requires Team Read-Write permission.

  1. Sign in at console.x.ai and select the team.

  2. Open Grok Business → Connectors.

  3. Choose + Add Connector.

    Add Connector button at the top right of the Grok Business connectors list
    Admins add a service with + Add Connector.
  4. Select a service and complete its setup.

  5. Have members open grok.com/connectors and connect their own accounts.

For a custom server, choose Other, enter its URL and complete any required authentication. Use Configure to adjust service-specific settings, such as allowed sites; Remove stops team members from connecting or using that connector.

Microsoft services can require administrator consent. If Teams or Outlook shows “need admin approval,” the IT administrator can grant consent for the xAI Grok application under Enterprise applications in the Azure AD admin portal.

SharePoint and OneDrive Admin Settings

Both require a Microsoft Entra tenant ID and Microsoft 365 administrator consent. Find the ID under Azure Active Directory → Overview.

An admin can approve directly, copy the consent link for IT, or consent later. SharePoint members cannot authenticate before consent.

SharePoint settingEffect
Delegated permissionsAccess is bounded by the connecting account’s site permissions.
Application-level permissionsAfter consent, the admin selects an allow list of sites and can change it in connector settings.
Enable Write AccessStarts separate consent for uploading and creating files; members must also opt in individually.
More detail: indexing and disconnection

SharePoint checks each requesting user’s access to indexed content. Disconnecting a member removes indexed data only that member could access; removing the connector removes the organization’s indexed data.

For OneDrive, disconnecting removes that account’s indexed data. Admin removal removes the organization’s indexed data.

Can I Connect a Custom Server?

A custom Model Context Protocol (MCP, a way to connect tools) server can expose your own tools, API or database to Grok.

Have a custom MCP server? link next to the Add Connector button in Grok Business
Teams can add their own server from the same screen.

Its URL must be reachable over the public internet. Grok rejects localhost and private addresses such as 127.0.0.1 and 192.168.x.x.

  1. Open New Connector → Custom.
  2. Enter the server URL.
  3. Complete any required authentication.
More detail: connecting a local server

For a local server, start a tunnel to its port and enter the public forwarding URL. For example, ngrok http 3001 exposes a server on port 3001.

Keep both running. If a temporary tunnel URL changes after restart, replace the connector with one using the new URL.

Cloudflare quick tunnels do not support Server-Sent Events (SSE, a way to stream updates); use ngrok for an MCP server using that transport. Authentication still applies when a tunnel supplies the public address.

Grok Connectors vs Grok Bot

They use separate screens. Grok Bot connections belong to your Bot account and work for every Bot you run.

Grok Bot Connect Apps window with gmail typed in the search box and matching apps listed
Grok Bot uses its own Connect Apps window.
Grok chatGrok Bot
Add services at grok.com/connectors.Open Connect apps in the Bot sidebar; on a phone, open the top-left avatar and then Connect apps.
Grok uses relevant connected tools in conversation.Type @ in Bot chat to attach an app, or ask a Bot to add an app.
Custom MCP uses a public server URL.A custom connector can use Remote HTTPS or Command.
Gmail connects your existing mailbox.The Email app can give your Bots their own mail.grokbot.com address.

See Grok Bot connectors, Grok pricing and Grok vs ChatGPT.

FAQ

What Are Connectors in Grok AI?

Quick answer: Connectors let Grok access external tools and data during a conversation. They can connect built-in services, catalog services or a custom MCP server.

Are Grok Connectors Free?

Quick answer: Connectors are available to all Grok users. Meltwater needs an active subscription, and OneDrive and SharePoint require Business or Enterprise.

Are Grok and Grok Bot Connectors the Same?

Quick answer: They are set up separately. Grok Bot apps belong to your Bot account and can be used by every Bot you run.

Can I Connect a Work Account?

Quick answer: Yes, after a team admin provisions the connector for your Business or Enterprise organization. You connect your own account, and some Microsoft services also require administrator consent.

How Do I Disconnect a Connector?

Quick answer: Open grok.com/connectors, find the connected service and select Disconnect. For Google and Microsoft services, you can also revoke the app’s access in the respective account permissions page.


Swarm School is an independent site. We’re not affiliated with xAI or Cursor.

Sources

Swarm School is independent and not affiliated with Grok Bot’s makers. Features change; check the official docs for current details.

Free 16-page Grok Bot Power User Guide (PDF). Enter your email and download it instantly.