📌Overview

Purpose: The Notion MCP Server facilitates seamless integration with Notion's API by providing a standardized interface for developers.

Overview: This server implementation of the Model Context Protocol (MCP) allows users to easily connect and interact with various functionalities available within Notion, supporting tasks such as querying databases and managing pages in real-time.

Key Features:

Database Management: Enables users to list, query, and manage Notion databases efficiently, enhancing productivity by allowing streamlined data operations.
Page Operations: Supports the creation and updating of pages, ensuring that users can dynamically interact with their content as needed.
Workspace Search: Facilitates quick searching across the Notion workspace, making it easier to find specific information swiftly.
Asynchronous Support: Full async/await functionality is provided, improving performance by allowing non-blocking operations.
Type Safety: Utilizes Pydantic models for type safety, ensuring robust code quality and reducing errors during development.
Error Handling: Incorporates proper error handling mechanisms to enhance the reliability of interactions with the Notion API.

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

Clone the repository:

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

Create a virtual environment and install dependencies:

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

Create a .env file in the project root:

NOTION_API_KEY=your_notion_integration_token

Usage

Test the server:
```
python -m notion_mcp
```

Configure the claude_desktop_config.json file:

"notion-mcp": {
    "command": "/Users/username/Projects/notion-mcp/venv/bin/python3", // Path to your virtual environment
    "args": ["-m", "notion_mcp"],
    "cwd": "/Users/username/Projects/notion-mcp" // Path to your project
}

Development

Project Structure

notion-mcp/
├── src/
│   └── notion_mcp/
│       ├── models/
│       ├── __main__.py
│       ├── client.py
│       └── server.py
├── .env
├── .gitignore
├── pyproject.toml
└── README.md

Running Tests

pytest

Configuration

To set up the server, obtain a Notion integration token:

Go to https://www.notion.so/my-integrations
Create a new integration
Copy the integration token
Add it to your .env file

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

MIT License - Use at your own risk