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 package manager
• Cline VSCode extension
• 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:

{
  "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
2. Verify your API key in the .env file
3. Ensure the server path in Cline's config is absolute

4. Check that uv is installed and in your PATH

5. Dependencies issues

6. Try reinstalling with fastmcp install notion_mcp_server.py --force

7. Verify uv is installed correctly

8. Server hangs

9. Ensure you're using the uv run command as specified in the config
10. Check the server logs for errors

Contributing

See mcp_instructions.md for detailed information about the server's implementation and architecture.

License

MIT