Notion Knowledge Base MCP Server

# Notion Knowledge Base MCP Server An MCP server that provides access to a Notion knowledge base through the Cline VSCode extension. ## Features - Query your Notion knowledge base directly from Cline - Get detailed answers with references to Notion pages - Built with FastMCP for reliable performance - Comprehensive error handling and logging ## Prerequisites - Python 3.10 or higher - [uv](https://github.com/astral-sh/uv) package manager - [Cline VSCode extension](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev) - A Dify API key for accessing the Notion knowledge base ## Installation 1. Clone this repository: ```bash git clone https://github.com/yourusername/notion-mcp-server.git cd notion-mcp-server ``` 2. Create a `.env` file with your Dify API key: ```bash echo "DIFY_API_BACKEND_KEY=your-api-key-here" > .env ``` 3. Install the server in Cline: ```bash fastmcp install notion_mcp_server.py ``` This will automatically: - Install all required dependencies using uv - Configure the server in Cline's settings - Make the server available to use with Cline ## Usage Once installed, you can use the server in Cline by asking questions about your Notion knowledge base. For example: ``` Tell me about internal tooling ``` The server will respond with relevant information from your Notion knowledge base, including: - Detailed answers - Links to relevant Notion pages - Page IDs for reference ## Configuration The server is configured automatically during installation, but you can manually update the settings in Cline's configuration file if needed: - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json` Example configuration: ```json { "mcpServers": { "notion-kb": { "command": "uv", "args": [ "run", "--with", "fastmcp", "--with", "python-dotenv", "--with", "requests", "fastmcp", "run", "/absolute/path/to/notion_mcp_server.py" ], "env": { "DIFY_API_BACKEND_KEY": "your-api-key" } } } } ``` ## Development For development and testing: 1. Install dependencies: ```bash pip install -r requirements.txt ``` 2. Run the development server: ```bash fastmcp dev notion_mcp_server.py ``` This will start the MCP Inspector interface for testing the server. ## Troubleshooting 1. **Server not connecting** - Verify your API key in the `.env` file - Ensure the server path in Cline's config is absolute - Check that uv is installed and in your PATH 2. **Dependencies issues** - Try reinstalling with `fastmcp install notion_mcp_server.py --force` - Verify uv is installed correctly 3. **Server hangs** - Ensure you're using the uv run command as specified in the config - Check the server logs for errors ## Contributing See [mcp_instructions.md](mcp_instructions.md) for detailed information about the server's implementation and architecture. ## License MIT