Notion MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 50 installs a week from npm. Last commit 23 Jun 2026.
Notion MCP server — search, export, and import pages as markdown
What the code does
We read the source, 2 d ago · rules 995398eba69f
What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.
fs.writeFileSync(path.join(imageDir, fname), got.buffer);
Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.
This code can reach further than it looks
We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.
Connect this server
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add notion-mcp -e 'NOTION_TOKEN=<NOTION_TOKEN>' -e 'NOTION_USER_ID=<NOTION_USER_ID>' -e 'NOTION_SPACE_ID=<NOTION_SPACE_ID>' -- npx -y @shck-dev/notion-mcp{
"mcpServers": {
"notion-mcp": {
"command": "npx",
"args": [
"-y",
"@shck-dev/notion-mcp"
],
"env": {
"NOTION_SPACE_ID": "<NOTION_SPACE_ID>",
"NOTION_TOKEN": "<NOTION_TOKEN>",
"NOTION_USER_ID": "<NOTION_USER_ID>"
}
}
}
}[mcp_servers.notion-mcp]
command = "npx"
args = ["-y", "@shck-dev/notion-mcp"]
env = { NOTION_TOKEN = "<NOTION_TOKEN>", NOTION_USER_ID = "<NOTION_USER_ID>", NOTION_SPACE_ID = "<NOTION_SPACE_ID>" }{
"mcpServers": {
"notion-mcp": {
"command": "npx",
"args": [
"-y",
"@shck-dev/notion-mcp"
],
"env": {
"NOTION_SPACE_ID": "<NOTION_SPACE_ID>",
"NOTION_TOKEN": "<NOTION_TOKEN>",
"NOTION_USER_ID": "<NOTION_USER_ID>"
}
}
}
}{
"servers": {
"notion-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@shck-dev/notion-mcp"
],
"env": {
"NOTION_SPACE_ID": "<NOTION_SPACE_ID>",
"NOTION_TOKEN": "<NOTION_TOKEN>",
"NOTION_USER_ID": "<NOTION_USER_ID>"
}
}
}
}Put your own values in place of
<NOTION_TOKEN> (Notion token_v2 cookie value from browser DevTools), <NOTION_USER_ID> (Notion user ID from x-notion-active-user-header), <NOTION_SPACE_ID> (Notion workspace ID from API request body).
The author’s registry entry marks them as required.
Alternatives to Notion MCP
same job, measured the same waySearch, read and write your Notion workspaces, with pages as Markdown and typed database queries.
nol MCP server -- search, cited Q&A, and pages over your team's knowledge base
Secure MCP server for MediaWiki wikis — search, pages, categories, and more
Search Notion and Supabase through one safety-focused MCP server.
Official Notion MCP server
Markdown-first Notion for AI agents -- pages, databases, blocks, and comments in one call.
Operate Notion with a single Markdown document — read, create, and update pages in one call.
Publish to self-hosted WordPress from AI agents: markdown, images, SEO, and Notion sync.
Notion MCP — questions
Answers built from our own checks of this server.