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

Clone this repository:
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 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:

Install dependencies:
pip install -r requirements.txt
Run the development server:
fastmcp dev notion_mcp_server.py

This will start the MCP Inspector interface for testing the server.

Troubleshooting

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
Dependencies issues
- Try reinstalling with fastmcp install notion_mcp_server.py --force
- Verify uv is installed correctly
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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP server that connects to your Notion knowledge base, allowing you to query and retrieve information directly from VSCode using the Cline extension.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Notion MCP Server
suekou
A
security
A
license
A
quality
MCP Server for the Notion API, enabling Claude to interact with Notion workspaces.
Last updated -
18
867
811
MIT License
Memory Box MCP Server
amotivv
A
security
A
license
A
quality
Cline MCP integration that allows users to save, search, and format memories with semantic understanding, providing tools to store and retrieve information using vector embeddings for meaning-based search.
Last updated -
12
7
MIT License
notion-mcp-server
awkoy
A
security
A
license
A
quality
Notion MCP Server is a MCP server implementation that enables AI assistants to interact with Notion's API.
Last updated -
13
312
131
MIT License
Notion MCP Server
hyunseok-ctrl
-
security
A
license
-
quality
An MCP server that enables natural language interaction with the Notion API, allowing users to search, comment, create pages, and access content within their Notion workspace.
Last updated -
46,432
MIT License

View all related MCP servers

Notion Knowledge Base MCP Server