Skip to main content

Connect Genie One to external applications with MCP

Connect Genie One to applications such as Gmail and Slack with MCP connectors. Genie One can then look up live information, such as the current status of a Jira issue. It can also take action, such as drafting an email, posting to a Slack channel, or updating an issue. Admins control access and policies for most connectors through Unity Gateway.

Each user authenticates individually, so Genie One works within each user's own permissions. OAuth tokens are not shared between users.

Types of MCP connectors​

You can connect Genie One to the following kinds of MCP servers:

Databricks-provided connectors and MCP services, including servers installed from Marketplace, run through Unity Gateway. Before each tool call, the gateway checks that the user has EXECUTE on the MCP, and it records usage and audit logs in system tables. Admins can also limit which tools are available and apply service policies (Beta), for example to block sensitive data or to require approval for a tool call.

The exceptions are Glean (Beta) and legacy MCP connections, which are Unity Catalog connections that aren't registered as MCP services. They don't run through the gateway, so these controls don't apply to them. See Govern an MCP.

Databricks-provided connectors​

Supported connectors include:

  • Google Drive: Search and create Google Docs, Sheets, and Slides; edit Docs it created.
  • Gmail: Search, read, and draft email.
  • Google Calendar: Search and create calendar events.
  • Microsoft 365: Search SharePoint, Teams, Outlook, and Calendar; draft Outlook email.
  • Atlassian: Search and update Jira and Confluence.
  • Asana: Search tasks, projects, portfolios, users, and teams, and create or update tasks when write actions are allowed.
  • Glean (Beta): Search across your organization's connected apps using Glean.
  • Slack: Search Slack messages and channels, and send messages.
  • GitHub: Search and update repositories, issues, and pull requests.
note

To use these connectors in a Genie Agent instead of Genie One, see Connect a Genie Agent to MCP tools and sources.

Connect an external application​

  1. On the Genie One home page, click the Plus icon. plus icon at the bottom left of the search bar.

  2. Click Connectors, then select an application.

    To connect additional applications, click Browse connectors at the bottom of the list. To add a custom MCP service, see Connect a custom MCP service.

  3. Click Sign in and complete the steps to sign in.

    If your organization blocks the sign-in, see Additional third-party app configuration.

The connection is added to your conversation. Genie One can now use its tools to look up information and take action. See Share an MCP.

note

Connector tools might not always trigger automatically. If a tool doesn't run, try explicitly prompting chat to use it, for example "use Google Drive" or "use SharePoint."

Connect a custom MCP service​

You can connect Genie One to any MCP server that is registered as an MCP service in Unity Catalog:

  • Register your own server: Register an external or self-hosted MCP server. See External MCP servers.
  • Install from Marketplace: Install an MCP server listed on Databricks Marketplace. The installation creates an MCP service in the Unity Catalog schema that you choose. See Get access to external MCP servers.

After the MCP service exists and you have access to it, add it to a chat conversation from Browse connectors. See Share an MCP. If the service uses per-user OAuth, each user must sign in before using it.

Reconnect an application​

If an administrator approves new permissions for an application after you sign in to it, revoke your credentials and sign in again so that your connection gets the new permissions:

  1. On the Genie One home page, click the Plus icon. plus icon at the bottom left of the search bar.
  2. Click Connectors, then click Browse connectors.
  3. Click the application.
  4. Click the Chevron down icon. down arrow next to Connected, then click Revoke credentials.
  5. Click Use connector and complete the steps to sign in.

When sign-in completes, the button shows Connected again.

Write actions​

Some connected MCP tools can perform write actions in the source application, not just search and read data. Whether a connection can write, and which actions it can take, depends on the tool, the OAuth scopes you consent to when you connect, and your own permissions in the source application.

OAuth scopes​

When you connect an external application, its provider prompts you to consent to a set of OAuth scopes. Scopes define the maximum set of actions a connection can attempt on your behalf. Each user consents individually. What a connection can access also depends on your own permissions in the source application and on any policies that your Databricks admins set in Unity Gateway.

Databricks manages the OAuth credentials for these connections. For the full list of scopes each managed OAuth provider requests and the purpose of each scope, see Managed OAuth providers. The exact set of scopes requested for a connection appears on the provider's consent screen when you connect.

For compliance guidance for connected applications, see External provider requirements.

Admin controls​

For connectors that run through Unity Gateway, admins control who can use each connector and which of its tools are available, and can apply service policies (Beta) to tool calls. See Govern an MCP.

Get admin approval for connectors​

Your Slack, Google Workspace, Microsoft 365, or GitHub administrators might need to approve or configure the Databricks app before users can sign in. For the steps for each provider, see Additional third-party app configuration.

Limitations​

External connections are only available in regions where Unity Gateway is supported.

See supported regions.

Scheduled tasks and authentication​

  • Chat doesn't warn you when a connection's authentication expires. You might only find out when a tool call fails or when you open the connections list. Re-authenticate to resolve.
  • Changing a connection's permissions requires each user to re-authenticate. Scheduled tasks that use the connection fail until the user re-authenticates.

Google Drive​

  • When authorizing Google Drive, you might see an Unverified app screen. Click Advanced and continue the authorization process.
  • Maximum file size is 25 MB.
  • Only native Google Workspace files (Docs, Sheets, Slides) are supported. PDFs, images, and other binary formats are not supported.
  • The connector can create Google Docs, Sheets, and Slides, and edit Google Docs it created. It can't edit Docs created outside the connector, or edit existing Sheets or Slides.
  • Reading a very large document can be slow.
note

The use and transfer of raw or derived user data received from Google Workspace APIs will adhere to the Google API services User Data Policy, including the Limited Use requirements.

Gmail​

  • The connector can search, read, and draft email, but it can't send email or edit existing messages.
  • The connector can't add Drive files as native Gmail attachments. As a workaround, include links to the files in the email body.

Microsoft 365​

  • Includes SharePoint, OneDrive, Teams, Outlook, Calendar, and online meetings.
  • The connector can draft Outlook email but can't send it.
  • Maximum file size is 25 MB for SharePoint files.
  • Supported SharePoint file types include built-in SharePoint documents, spreadsheets, and presentations, as well as common text-based formats such as .txt, .csv, .json, .md, and others. PDFs, images, and other binary formats are not supported.

Glean (Beta)​

  • Glean is search-only. It can't read a document from a direct link.
  • A metastore admin must first configure the Glean tenant ID before non-admin users can use the connection. The admin can enter the tenant ID when first connecting to Glean.
  • To connect to a specific Glean MCP server, a metastore admin can optionally set the MCP server path (for example, /mcp/eng) when setting up the connection. Leave this field blank to use the default path (/mcp/default). Non-admin users cannot specify or change the Glean MCP server path.

Slack​

  • The connector can't edit or delete a message after sending it.

GitHub​

  • Writes are limited to file contents, issues, and pull requests.
  • By default, the Databricks GitHub MCP connector can access only public repositories. To access private repositories, or to make changes such as committing files or creating issues and pull requests, the repository owner or a GitHub organization administrator must complete additional setup. See Enable GitHub write access and private repository access.
  • GitHub Enterprise Server (the self-hosted version of GitHub) is not supported.