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

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

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

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.

Notion Direct MCP Server

Notion Direct MCP Server

Features

Setup

1. Install Dependencies

2. Get Notion Integration Token

3. Configure Claude Code

4. Restart Claude Code and Connect

Available Tools

Usage Examples

Search for a project

Create a task page

Query database

Troubleshooting

For New Projects

New MCP Servers

MCP directory API