NotionMCP Server

A Python server that integrates MCP with Notion to automate documentation workflows and manage Notion via LLMs.

Features

• Exposes MCP tools for creating, updating, and searching Notion pages

• Converts plain text and markdown-like content into Notion blocks

• Supports appending and replacing content in Notion pages

• Provides debug information for troubleshooting

Requirements

• Python 3.10+

• Notion integration token and parent page ID

• MCP server and CLI

• See requirements.txt for Python dependencies

Setup

1. Clone the repository and navigate to the project directory.

2. Install dependencies:

   pip install -r requirements.txt

3. Configure environment variables:

   • Find the related API key and parent page ID from your Notion

   • API key is the integration key

   • Parent page ID is the target page we use to interact with LLMs prompt

   • Set NOTION_API_KEY and NOTION_PARENT_ID in .env file

4. Run the server:

   python notionMCP_server.py

5. Edit LLMs config file to recognize MCP server:

   • In this project, I used Claude desktop, here is how to edit the config

   • Find claude_desktop_config.json and edit as follows:

   { "mcpServers": { "NotionMCP": { "command": "path_to_the_exe_python_file_running_your_server", "args": ["path_to_python_server_file(notionMCP_server.py)"], "env": {} } } }

   • Use which python to find the executable python file running your server

License

MIT License