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

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

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