Notion (MCP) - Nango Docs

🚀 Quickstart

Connect to the Notion MCP server with Nango and call MCP tools in minutes. Notion MCP uses OAuth 2.0 with dynamic client registration, so no app registration is required.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Notion (MCP).

Authorize Notion

Go to Connections -> Add Test Connection -> Authorize, then log in to Notion. Later, you’ll let your users do the same directly from your app.

Call a Notion MCP tool

Make your first MCP request (initialize handshake). Replace the placeholders below with your API key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/mcp" \
  -X POST \
  -H "Authorization: Bearer <NANGO-API-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
        "protocolVersion": "2024-11-05",
        "capabilities": {},
        "clientInfo": {
            "name": "nango-client",
            "version": "1.0.0"
        }
    }
}'

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-API-KEY>' });

const res = await nango.post({
    endpoint: '/mcp',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>',
    body: {
        jsonrpc: '2.0',
        id: 1,
        method: 'initialize',
        params: {
            protocolVersion: '2024-11-05',
            capabilities: {},
            clientInfo: {
                name: 'nango-client',
                version: '1.0.0'
            }
        }
    }
});

console.log(res.data);

Or fetch credentials with the Node SDK or API. ✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.

​🚀 Quickstart

​📚 Notion (MCP) guides

🚀 Quickstart

📚 Notion (MCP) guides