​
Prerequisites

To get the most out of this guide, you’ll need to:

​
1. Create a Notion MCP Server

Use the following endpoint to create a new remote Notion MCP server instance:

​
Request

curl --request POST \
  --url https://api.klavis.ai/mcp-server/instance/create \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "serverName": "Notion",
  "userId": "<YOUR_USER_ID>",
  "platformName": "<YOUR_PLATFORM_NAME>"
}'

​
Response

{
  "serverUrl": "https://notion-mcp-server.klavis.ai/sse?instance_id=<instance-id>",
  "instanceId": "<instance-id>"
}
serverUrl specifies the endpoint of the Notion MCP server, which allows you to interact with Notion pages, databases, and blocks.
instanceId is used to get an authentication token. After you complete the OAuth flow, this token allows the MCP server to access Notion on your behalf.

​
2. Notion OAuth Flow

To enable your MCP server to access Notion, you need to authenticate with Notion’s OAuth flow.

const authUrl = `https://api.klavis.ai/oauth/notion/authorize?instance_id=${instanceId}`;
window.location.href = authUrl;

​
Watch the Example

​
Explore MCP Server Tools