Provides direct API integration with Notion for managing pages, databases, and blocks - including search, create, read, update operations, database queries with filters and sorts, and block-level content manipulation
Notion Direct MCP Server
A simple, reliable MCP server for Notion that uses the Notion API directly.
Features
Direct API Integration: No middleware, just direct API calls that work
Core Operations: Search, create, read, update pages and databases
Block Operations: Read and append blocks to pages
Simple & Reliable: Minimal dependencies, easy to debug
Setup
1. Install Dependencies
2. Get Notion Integration Token
Create a new internal integration
Copy the token (starts with
ntn_
)Grant the integration access to your pages/databases
3. Configure Claude Code
Add to ~/.config/claude-code/config.json
:
4. Restart Claude Code and Connect
Run /mcp
in Claude Code to connect to the server.
Available Tools
search_notion
: Search for pages and databasesget_page
: Get page details by IDcreate_page
: Create a new pageupdate_page
: Update page propertiesquery_database
: Query a database with filters and sortsget_block_children
: Get child blocks of a pageappend_blocks
: Append blocks to a page
Usage Examples
Search for a project
Create a task page
Query database
Troubleshooting
Token issues: Make sure your token starts with
ntn_
and has access to your pagesConnection issues: Check that the virtual environment path is correct
API errors: All errors are returned in the tool response for easy debugging
For New Projects
To use this server in other projects:
Grant your Notion integration access to the project pages
Use the same config in Claude Code
No additional setup needed!
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables direct interaction with Notion through the Notion API for searching, creating, reading, and updating pages and databases. Supports core operations like page management, database queries, and block operations without middleware dependencies.