Skip to main content
Glama

Notion Direct MCP Server

README.md2.4 kB
# 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 ```bash cd ~/mcp-servers/notion-direct python3 -m venv .venv source .venv/bin/python pip install -r requirements.txt ``` ### 2. Get Notion Integration Token 1. Go to https://www.notion.so/profile/integrations 2. Create a new internal integration 3. Copy the token (starts with `ntn_`) 4. Grant the integration access to your pages/databases ### 3. Configure Claude Code Add to `~/.config/claude-code/config.json`: ```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: 1. Grant your Notion integration access to the project pages 2. Use the same config in Claude Code 3. No additional setup needed!

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Wayy-Research/notion-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server