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:

   git clone https://github.com/yourusername/notion-mcp-server.git
   cd notion-mcp-server

2. Create a .env file with your Dify API key:

   echo "DIFY_API_BACKEND_KEY=your-api-key-here" > .env

3. Install the server in Cline:

   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:

   pip install -r requirements.txt

2. Run the development server:

   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 for detailed information about the server's implementation and architecture.

License

MIT