Notion remote MCP connector

  • Updated

The Notion remote Model Context Protocol (MCP) connector in Optimizely Opal lets you interact with and manage your Notion workspace directly within your AI-driven workflows.

These tools let Opal programmatically search, fetch, create, and update pages and databases. They bridge the gap between your collaborative documentation and your marketing operations. Use them to automate project status updates, sync campaign briefs, or query organizational knowledge. Your documentation stays actionable and synced across the Optimizely ecosystem.

The Notion remote MCP is managed by Notion. For details, see Notion MCP in the Notion documentation.

First, an Opal administrator must connect the Notion remote MCP to Opal. After connecting the MCP server, individual Opal users and agent builders can log in to Notion to access their information from Opal. Administrators only need to connect the Notion remote MCP once.

Connect the Notion remote MCP to Opal

Opal administrators connect and grant access to Notion from Opal. After granting access, administrators select which tools to enable in Opal and optionally customize their display names.

Add Notion connection

As an Opal administrator, complete the following steps:

  1. Go to Connectors in Opal.
  2. (Optional) Enter Notion in the search bar to filter the connectors list.

  3. Click Connect on the Notion tile. 

  4. Log in to your Notion account.

  5. Configure the connector.

  6. Click Continue.

A confirmation message displays and you can close the pop-up window.

Configure Opal tools

After adding the Notion connection, Opal prompts you to select which tools to enable and optionally customize their display names.

As an Opal administrator, complete the following steps:

  1. Deselect any tools you do not want to add to Opal.
  2. (Optional) Update any tool's display name.

  3. Click Finish. 

The Notion tile displays Connect on the Connectors tab for Opal users to authenticate with their personal accounts.

To update the available tools or names, see Update tools.

Authenticate with Notion

Each Opal user and agent builder logs in to Notion individually to access their Notion data from Opal. User-level authentication ensures you access only the data your Notion account is authorized to view.

Before you begin, confirm that an Opal administrator has connected the Notion remote MCP to Opal. Until an administrator connects it, the Notion tile displays Contact admin instead of Connect and you cannot select it.

To authenticate, complete the following steps in Opal:

  1. Go to Connectors.
  2. (Optional) Enter Notion in the search bar to filter the connectors list.
  3. Click Connect on the Notion tile.
  4. Log in to Notion.

After you connect to Notion, the Notion connector tools your administrator added become available in Opal Chat, agents, and workflows.

Notion connector tools

The Notion connector tools are available in Opal after an administrator connects the Notion remote MCP to Opal and you log in to Notion. The available tools depend on which tools your administrator enabled. For a full list of available tools and actions, see Notion MCP in the Notion developer documentation.

Update tools

To rename, add, or remove tools, an Opal administrator must delete the Notion tools registry and re-add it. To do so, complete the following steps:

  1. Follow the steps in Delete a tool registry.
  2. Add Notion connection.
  3. Configure Opal tools.

If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See Turn generative AI off across Optimizely applications.