NotionMCP Server

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