Notion Knowledge Base MCP Server

What is Notion Knowledge Base MCP Server?

An MCP server that provides access to a Notion knowledge base through the Cline VSCode extension, enabling users to query Notion pages and receive detailed answers with references.

How to use Notion Knowledge Base MCP Server?

Install prerequisites (Python 3.10+, uv, Cline extension, Dify API key), clone the repository, create a .env file with your Dify API key, then run fastmcp install notion_mcp_server.py. Once installed, ask questions about your Notion knowledge base directly in Cline.

Key features of Notion Knowledge Base MCP Server

• 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

Use cases of Notion Knowledge Base MCP Server

• Ask about internal tooling and receive relevant Notion page links
• Retrieve detailed answers from a company knowledge base via Cline
• Get page IDs for direct reference from Notion

FAQ from Notion Knowledge Base MCP Server

What are the prerequisites for using this server?

Python 3.10 or higher, the uv package manager, the Cline VSCode extension, and a Dify API key for accessing the Notion knowledge base.

How do I install the server?

Clone the repository, create a .env file with your Dify API key, then run fastmcp install notion_mcp_server.py. This installs dependencies and configures the server in Cline automatically.

How can I manually configure the server?

Edit Cline’s configuration file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json) with the absolute path to the script and the DIFY_API_BACKEND_KEY environment variable.

How do I troubleshoot connection issues?

Verify your API key in the .env file, ensure the server path in Cline’s config is absolute, and check that uv is installed and in your PATH. Reinstall with fastmcp install notion_mcp_server.py --force if needed.

What dependencies are required?

FastMCP, python-dotenv, and requests. They are installed automatically by uv during the fastmcp install command.