Notion (official)
Last tested 2026-10-22
Score 90/100 · Last tested 2026-10-22 · Version tested 2.5.2 · Package @notionhq/notion-mcp-server · Repo makenotion/notion-mcp-server
Summary: Notion (official) completed an MCP handshake without credentials and exposed 24 tools.
Test results
| Test | Result | Points | Evidence |
|---|---|---|---|
| install | pass | 20 | npm install @notionhq/notion-mcp-server (Node 20, Linux) succeeded in 2s. |
| handshake | pass | 30 | MCP initialize + tools/list over stdio succeeded with no credentials; 24 tools listed in 15.0s. |
| maintenance | partial | 15 | Repo pushed 31 days before test. |
| docs | pass | 15 | README over 3,000 chars; install instructions present; mcpServers config example present. Automated check of the package's own README (README shipped in npm package). |
| license | pass | 10 | MIT (OSI-approved). |
Local-model readiness
Schema context cost: ~16,536 tokens for 24 tools (74,666 bytes) · about 202% of an 8k context. Method: tiktoken cl100k_base over compact JSON of name+description+inputSchema (approximate).
Small-model friendly (schema heuristic, not a model result): medium.
Small-model task runs: Not yet tested.
Not tested
We did not test behavior with real credentials, security, or performance under load. These are planned; see methodology.
Tools listed
API-get-user, API-get-users, API-get-self, API-post-search, API-get-block-children, API-patch-block-children, API-retrieve-a-block, API-update-a-block, API-delete-a-block, API-retrieve-a-page, API-patch-page, API-post-page, API-retrieve-a-page-property, API-retrieve-a-comment, API-create-a-comment, API-query-data-source, API-retrieve-a-data-source, API-update-a-data-source, API-create-a-data-source, API-list-data-source-templates, API-retrieve-a-database, API-move-page, API-retrieve-page-markdown, API-update-page-markdown
Config used in our test
{
"mcpServers": {
"notion-official": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
]
}
}
}FAQ
Is Notion (official) deprecated?
No. @notionhq/notion-mcp-server was not deprecated or archived when we last tested it on 2026-10-22.
What replaces Notion (official)?
Nothing; Notion (official) is not deprecated as of 2026-10-22.
Does Notion (official) need an API key?
No. It completed an MCP handshake with no credentials and listed 24 tools.
Embed the badge
The badge always shows the current score; payment never changes it.