Notion
Created 6 months ago
Notion MCP is a remote MCP server with easy installation and powerful tools for AI agents.
development
documentation
public
What is Notion?
This project implements an MCP server for the Notion API.
Documentation
Notion MCP Server# Installation
-
Setting up Integration in Notion: Go to Notion Integrations and create a new internal integration or select an existing one.
-
Connecting content to integration: Ensure relevant pages and databases are connected to your integration.
-
Adding MCP config to your client:
- Using npm:
- Option 1: Using NOTION_TOKEN (recommended)
- Option 2: Using OPENAPI_MCP_HEADERS (for advanced use cases)
- Using Docker:
- Option 1: Using the official Docker Hub image
- Option 2: Building the Docker image locally
Transport Options
The Notion MCP Server supports two transport modes:
- STDIO Transport (Default)
- Streamable HTTP Transport
Authentication
The Streamable HTTP transport requires bearer token authentication.
Examples
- Using the instruction
Comment "Hello MCP" on page "Getting started"will plan two API calls. - The instruction
Add a page titled "Notion MCP" to page "Development"will add a new page.
Server Config
{
"mcpServers": {
"notion-server": {
"command": "npx",
"args": [
"notion"
]
}
}
}
Links & Status
Project Info
Hosted
Featured
Created At:
May 23, 2025
Updated At:
Aug 07, 2025
Author:
makenotion
Category:
official
License:
MIT
Tags:
development
documentation
public