kirvigen/notion-private-api-mcp

Overview

An unofficial MCP server for Notion that uses the private API (tokenv2) instead of the official integration token. It provides full read and write access to Notion workspaces. Built in JavaScript, it is a community project with limited adoption.

Best for

Best for
Developers who need full Notion access but cannot or prefer not to use the official API

Use cases

• Automate Notion page creation and updates without an official API token
• Build custom MCP tools that read and write Notion databases
• Integrate Notion with other MCP-compatible applications

How to use

Install

npm start

Tools exposed

• get_page
• get_block
• get_block_children
• get_style_documentation
• markdown_to_blocks
• create_page
• append_blocks
• replace_page_content
• update_block_text
• delete_blocks
• sync_markdown_file

Tested with

Claude Desktop, Claude Code, Cursor

Example client config

[object Object]

Notes

An unofficial MCP server for Notion that uses the private API (tokenv2) instead of the official integration token. It provides full read and write access to Notion workspaces. Built in JavaScript, it is a community project with limited adoption.

1 stars on GitHub. Last updated 2026-06-01. Licensed MIT.

Use cases

• Automate Notion page creation and updates without an official API token
• Build custom MCP tools that read and write Notion databases
• Integrate Notion with other MCP-compatible applications

Pros

• Full read and write access to Notion workspaces
• No need for an official Notion integration token
• Works with existing Notion accounts via tokenv2

Cons

• Relies on the private API which may break without notice
• Very low community adoption (1 star) suggests limited reliability
• Using tokenv2 poses security risks and is not officially supported

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.