notion-mcp-server
A community Notion MCP server by awkoy, published on npm as notion-mcp-server and as a container image, that runs locally and authenticates with a single Notion token (a personal access token or an internal integration secret), so it suits headless use in CI or background agents.
What it does
A community Notion MCP server by awkoy, published on npm as notion-mcp-server and as a container image, that runs locally and authenticates with a single Notion token (a personal access token or an internal integration secret), so it suits headless use in CI or background agents. It keeps its tool count to three, with batched writes that can roll back, retries on rate limits and Markdown in both directions. Agents can search, query databases with filters, create and edit pages, comment and upload files. Setup instructions cover Codex, Gemini CLI, VS Code, Cursor and both Claude apps, and it also ships as a Claude Code plugin with a workflow skill.
Capabilities
- Search a Notion workspace and filter database rows
- Create and edit pages with Markdown
- Batch many page writes into one call
- Comment on pages
- Upload files to pages
Install
- Run this to add it to Claude Code:
claude mcp add notion -s user -e NOTION_TOKEN=ntn_paste_your_token_here -- npx -y notion-mcp-server
From the project's documentation · Add to a config file with the config builder
Details
| Fact | Value | Source |
|---|---|---|
| Type | MCP server | |
| Tool | Notion | |
| Publisher | awkoy | source |
| Official status | Community (not published by the tool's vendor) | source |
| Connection | Local (runs on your computer) | source |
| Can change data | Yes | source |
| Needs an API key or sign-in | Yes | source |
| Platforms | Not stated in its documentation | |
| AI clients | Claude Code, Claude Desktop, Cursor, Visual Studio Code, Codex, Gemini CLI | source |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 9, 2026Version 3.4.0180 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository npm: notion-mcp-serverdocker: ghcr.io/awkoy/notion-mcp-server |
Sources
- GitHub repositorygithub.com/awkoy/notion-mcp-server · Backs: AI clients, Can change data, Connection, Needs an API key or sign-in, Official status, Publisher, Activity, LicenceNov 10, 2026
- Licence file (LICENSE)github.com/awkoy/notion-mcp-server · Backs: LicenceNov 12, 2026
- MCP Registry entryio.github.awkoy/notion-mcp-server · Backs: Connection, Needs an API key or sign-inNov 10, 2026
- npm package recordnpmjs.com/package/notion-mcp-serverNov 10, 2026