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

cd ~/mcp-servers/notion-direct python3 -m venv .venv source .venv/bin/python pip install -r requirements.txt

2. Get Notion Integration Token

Go to https://www.notion.so/profile/integrations
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:

{ "mcpServers": { "notion": { "command": "/home/rcgalbo/mcp-servers/notion-direct/.venv/bin/python", "args": ["/home/rcgalbo/mcp-servers/notion-direct/server.py"], "env": { "NOTION_TOKEN": "your_token_here" } } } }

4. Restart Claude Code and Connect

Run /mcp in Claude Code to connect to the server.

Available Tools

search_notion: Search for pages and databases
get_page: Get page details by ID
create_page: Create a new page
update_page: Update page properties
query_database: Query a database with filters and sorts
get_block_children: Get child blocks of a page
append_blocks: Append blocks to a page

Usage Examples

Search for a project

Use the search_notion tool to find "WNY Leaf" project

Create a task page

Create a new task page under the WNY Leaf project with title "Implement backend API"

Query database

Query the tasks database and show all incomplete tasks

Troubleshooting

Token issues: Make sure your token starts with ntn_ and has access to your pages
Connection issues: Check that the virtual environment path is correct
API errors: All errors are returned in the tool response for easy debugging