Notion

Notion MCP Server

Open Notion SSE stream

get

Establishes a Server-Sent Events (SSE) connection to receive real-time notifications from the Notion MCP server. This endpoint acts as a proxy to the underlying MCP server.

Authorizations

BearerAuth

AuthorizationstringRequired

OAuth2 access token for authenticated requests

Header parameters

Mcp-Session-IdstringOptional

Optional MCP session identifier

Responses

200

SSE stream established

text/event-stream

Responsestring

401

Unauthorized

404

MCP server not found

get

/api/v1/mcps/notion

HTTPcURLJavaScriptPython

GET /api/v1/mcps/notion HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

text

Send JSON-RPC request to Notion

post

Send a JSON-RPC 2.0 request to the Notion MCP server. This endpoint acts as a proxy, forwarding your request to the underlying MCP server.

Authorizations

BearerAuth

AuthorizationstringRequired

OAuth2 access token for authenticated requests

Header parameters

Mcp-Session-IdstringOptional

Optional MCP session identifier

Body

application/json

jsonrpcstring · enumRequired

JSON-RPC version

Possible values:

methodstringRequired

Method name

Example: tools/list

idone ofRequired

Request identifier

stringOptional

or

integerOptional

or

nullOptional

Responses

200

JSON-RPC response

application/json

401

Unauthorized

404

MCP server not found

post

/api/v1/mcps/notion

HTTPcURLJavaScriptPython

POST /api/v1/mcps/notion HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 58

{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "params": {},
  "id": 1
}

List toolsCall a tool

{
  "jsonrpc": "2.0",
  "result": null,
  "error": {
    "code": -32600,
    "message": "Invalid request",
    "data": null
  },
  "id": "text"
}

Terminate Notion session

delete

Terminate an active MCP server session with the Notion MCP server.

Authorizations

BearerAuth

AuthorizationstringRequired

OAuth2 access token for authenticated requests

Header parameters

Mcp-Session-IdstringRequired

MCP session identifier

Responses

204

Session terminated successfully

401

Unauthorized

404

MCP server or session not found

delete

/api/v1/mcps/notion

HTTPcURLJavaScriptPython

DELETE /api/v1/mcps/notion HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Mcp-Session-Id: text
Accept: */*

No content

Open Notion SSE stream with path

get

Authorizations

BearerAuth

AuthorizationstringRequired

OAuth2 access token for authenticated requests

Path parameters

pathstringRequired

Additional path segments

Header parameters

Mcp-Session-IdstringOptional

Optional MCP session identifier

Responses

200

SSE stream established

text/event-stream

Responsestring

401

Unauthorized

404

MCP server not found

get

/api/v1/mcps/notion/{path}

HTTPcURLJavaScriptPython

GET /api/v1/mcps/notion/{path} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

text

Send JSON-RPC request with path to Notion

post

Authorizations

BearerAuth

AuthorizationstringRequired

OAuth2 access token for authenticated requests

Path parameters

pathstringRequired

Additional path segments

Header parameters

Mcp-Session-IdstringOptional

Optional MCP session identifier

Body

application/json

jsonrpcstring · enumRequired

JSON-RPC version

Possible values:

methodstringRequired

Method name

Example: tools/list

idone ofRequired

Request identifier

stringOptional

or

integerOptional

or

nullOptional

Responses

200

JSON-RPC response

application/json

401

Unauthorized

404

MCP server not found

post

/api/v1/mcps/notion/{path}

HTTPcURLJavaScriptPython

POST /api/v1/mcps/notion/{path} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 58

{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "params": {},
  "id": 1
}

List toolsCall a tool

{
  "jsonrpc": "2.0",
  "result": null,
  "error": {
    "code": -32600,
    "message": "Invalid request",
    "data": null
  },
  "id": "text"
}

Terminate Notion session with path

delete

Authorizations

BearerAuth

AuthorizationstringRequired

OAuth2 access token for authenticated requests

Path parameters

pathstringRequired

Additional path segments

Header parameters

Mcp-Session-IdstringRequired

MCP session identifier

Responses

204

Session terminated successfully

401

Unauthorized

404

MCP server or session not found

delete

/api/v1/mcps/notion/{path}

HTTPcURLJavaScriptPython

DELETE /api/v1/mcps/notion/{path} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Mcp-Session-Id: text
Accept: */*

No content