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", 
        
            
                4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

## License

MIT License - Use at your own risk

## Acknowledgments

- Built to work with Claude Desktop
- Uses Notion's API
- Special thanks to [danhilse], I referenced his [notion-mcp-server](https://github.com/danhilse/notion-mcp-server) project