Notion MCP Server

A Model Context Protocol (MCP) server implementation for Notion integration, providing a standardized interface for interacting with Notion's API.

Features

• List and query Notion databases
• Create and update pages
• Search across Notion workspace
• Full async/await support
• Type-safe with Pydantic models
• Proper error handling

Installation

1. Clone the repository:

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

2. Create a virtual environment and install dependencies:

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   pip install -e .

3. Create a .env file in the project root:

   NOTION_API_KEY=your_notion_integration_token

Usage

1. Test the server(it should just run without errors):

   python -m notion_mcp

2. To actually use it with Claude Desktop as intended you need to adjust your claude_desktop_config.json file

"notion-mcp": {
            "command": "/Users/username/Projects/notion-mcp/venv/bin/python3",