Notion Knowledge

Provides access to a Notion knowledge base via MCP, returning detailed answers with Notion page references.

python

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "rickydata-indexer-notion_mcp_server": {
      "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"
      }
    }
  }
}

You can query your Notion knowledge base directly from an MCP client, getting detailed answers with references to Notion pages. This server uses FastMCP for fast, reliable responses and includes solid error handling and logging to help you troubleshoot.

How to use

You interact with the MCP server from your MCP client by asking questions about your Notion knowledge base. Start with natural language prompts such as “Tell me about internal tooling” or “Show me guidelines for onboarding” and the server will return detailed answers with links to relevant Notion pages and page IDs for reference. You can combine questions to refine results, and if a page is cited, you’ll see direct references to the Notion pages used to generate the answer.

How to install

Prerequisites and steps you need to follow to set up the Notion knowledge base MCP server.

Prerequisites:

Python 3.10 or higher. You need Python to run the MCP server.
uv package manager. This is used to run the MCP server.
Cline VSCode extension. This enables you to connect to and use the MCP server from your editor.
A Dify API key. This key grants access to the Notion knowledge base through the server.

Step by step commands to set up the server from scratch:

Clone the repository and move into its directory.

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

cd notion-mcp-server

Create a .env file with your Dify API key.

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

Install the MCP server in Cline.

fastmcp install notion_mcp_server.py

This will automatically install required dependencies, configure the server in Cline’s settings, and make the server available for use with Cline.

Additional sections

Configuration is handled automatically during installation, but you can adjust settings later if needed. You’ll see a sample configuration that shows how the MCP server is wired for use.

Sample configuration you may encounter in your setup:

{
  "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"
      }
    }
  }
}

Built by

VeilStrat

AI signals for GTM teams