Docs

Configure the Notion MCP Server

Updated 1 min read

Overview

Notion operates an official hosted MCP server at mcp.notion.com, covering pages, databases, comments, and connected search into Slack, Google Drive, and Jira content shared with the integration. Access is authorized through OAuth 2.1 with dynamic client registration; during authorization you choose which pages and databases to share with the connection, since Notion doesn’t grant blanket workspace access.

1. Add the MCP server to your gateway config

In the mcp_servers section of your gateway configuration add the following entry:

  - name: notion
    description: "Notion's official hosted MCP server for pages, databases, and comments."
    url: https://mcp.notion.com/mcp
    transport_type: streamablehttp
    authentication:
      type: oauth
      grant_type: authorization_code
      scopes:
        - default
      issuer: "https://mcp.notion.com"
      redirect_uri: "https://demo.dev.dtwo.ai/oauth/callback"

Replace redirect_uri with your own Dtwo gateway’s OAuth callback URL, found in the Configuration section for your gateway in the Dtwo UI.

2. Deploy and verify

Save the configuration and deploy the gateway.

Then, in your AI client, ask it to authorize Notion via the gateway. This opens the Notion login screen — sign in as the user whose permissions the agent should inherit, review the workspace name, and choose which pages and databases to share with the connection before approving. To share additional content later, open the page in Notion, use the ··· menu, and add the connection under Connections. Once authorized, confirm the server’s tools appear and run a quick call to make sure the connection works.

Having trouble? Email support@dtwo.ai.