better-notion-mcp
An open-source MCP server that provides a Markdown-first interface for AI agents to interact with Notion. It enables agents to manage pages, databases, blocks, and comments through a unified API, facilitating seamless integration of Notion data into AI workflows.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
Checks and signals
Each line is separate evidence, not a trust score.
- Popularity 36 GitHub stars
What you can do with it
- Manage Notion pages and databases
- Create and edit blocks
- Add comments to Notion pages
Source and maintenance
- Last repository push
- Latest release
- v2.42.0
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
docker.io/n24q02m/notion:latest
{
"transport": "stdio",
"identifier": "docker.io/n24q02m/notion:latest",
"runtimeHint": "docker",
"registryType": "oci",
"environmentVariables": [
{
"name": "NOTION_TOKEN",
"isRequired": true,
"description": "Notion integration token. Create at https://www.notion.so/my-integrations"
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · repository · passed · metadata changed · updated
- · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"better-notion-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"NOTION_TOKEN=<YOUR_NOTION_TOKEN>",
"docker.io/n24q02m/notion:latest"
],
"env": {
"NOTION_TOKEN": "<YOUR_NOTION_TOKEN>"
}
}
}
}Cline
{
"mcpServers": {
"better-notion-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"NOTION_TOKEN=<YOUR_NOTION_TOKEN>",
"docker.io/n24q02m/notion:latest"
],
"env": {
"NOTION_TOKEN": "<YOUR_NOTION_TOKEN>"
}
}
}
}VS Code
{
"servers": {
"better-notion-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"NOTION_TOKEN=<YOUR_NOTION_TOKEN>",
"docker.io/n24q02m/notion:latest"
],
"env": {
"NOTION_TOKEN": "<YOUR_NOTION_TOKEN>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"better-notion-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"NOTION_TOKEN=<YOUR_NOTION_TOKEN>",
"docker.io/n24q02m/notion:latest"
],
"env": {
"NOTION_TOKEN": "<YOUR_NOTION_TOKEN>"
}
}
}
}Let your agent find its tools
Find servers like better-notion-mcp from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.