notion
Markdown-first Notion for AI agents -- pages, databases, blocks, and comments in one call.
What can you do with notion?
- Markdown in, Markdown out -- human-readable content instead of raw JSON blocks
- 8 composite tools, 39 actions -- one call instead of chaining 2+ atomic Notion endpoints (plus config and help)
- Auto-pagination and bulk operations -- no manual cursor handling or looping
- Tiered token optimization -- ~77% reduction via compressed descriptions + on-demand help tool
- Dual transport -- local stdio (integration token) or remote HTTP (per-user or shared bearer token)
Features as listed in the project's README, checked 16 Nov 2026.
About notion
Markdown-first Notion for AI agents -- pages, databases, blocks, and comments in one call.
Opening text of the project's README, checked 16 Nov 2026.
Install
{
"mcpServers": {
"notion": {
"command": "npx",
"args": [
"-y",
"@n24q02m/notion"
],
"env": {
"NOTION_TOKEN": "<your NOTION_TOKEN>"
}
}
}
}Config as documented in its source, checked 16 Nov 2026. Placeholders such as API keys are the project's own: replace them with your values.
Setup documented for
Tools (10)
| pages | notion pages [flags] |
| databases | notion databases [flags] |
| blocks | notion blocks --block-id |
| users | notion users |
| workspace | notion workspace [flags] |
| comments | notion comments [flags] |
| content_convert | notion contentconvert --direction --content ` |
| file_uploads | notion fileuploads [flags]` |
| config | notion config-tool |
| help | notion help |
Tool names from the README, checked 16 Nov 2026.
notion compared with other Notion servers
| Server | Licence | Tools | Last commit | Stars |
|---|---|---|---|---|
| notion | Apache-2.0 | 10 | 14 Nov 2026 | 36 |
| easy-notion-mcp | MIT | 43 | 11 Sept 2026 | 55 |
| Notion Large File Upload | MIT | 3 | 28 Oct 2026 | 13 |
Every value is a checked fact on that server's own page. This is a comparison of facts, not a ranking.
Verified facts
- Maintainer
- n24q02m
Source · checked 16 Nov 2026
- Licence
- Apache-2.0
Source · checked 16 Nov 2026
- Transport
- stdio
Source · checked 16 Nov 2026
- Required settings
- Environment variables: NOTION_TOKEN
Source · checked 16 Nov 2026
- Setup documented for
- Claude Code
- Cursor
- Codex
- OpenCode
Source · checked 16 Nov 2026
- Repository
- github.com/n24q02m/notion
Source · checked 16 Nov 2026
- Package
- @n24q02m/notion (npm)
Source · checked 16 Nov 2026
- Latest version
- 2.43.0
Source · checked 16 Nov 2026
- Last commit
- 14 Nov 2026
Source · checked 16 Nov 2026
- GitHub stars
- 36
Source · checked 16 Nov 2026
- Open issues
- 1
Source · checked 16 Nov 2026
Each value links to where it was found and shows the date it was checked. How we verify
Frequently asked questions
What does notion do?
Markdown-first Notion for AI agents -- pages, databases, blocks, and comments in one call.
Which MCP clients does notion document setup for?
Its README documents setup for Claude Code, Cursor, Codex, OpenCode.
How do I install notion?
Add the install config shown on this page to your MCP client's configuration; the package is @n24q02m/notion (npm). Check the README for client-specific steps.
What licence is notion under?
Apache-2.0, as reported by the repository on 16 Nov 2026.
Is notion still maintained?
The last commit was on 14 Nov 2026, and the repository had 1 open issues.
What settings does notion need?
Environment variables: NOTION_TOKEN.
What tools does notion expose?
10 tools: pages, databases, blocks, users, workspace, comments, content_convert, file_uploads, config, help.
