Notion MCP Server

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

Features

• List and query Notion databases.
• Create and update pages within Notion.
• Perform searches across the Notion workspace.
• Utilizes async/await for asynchronous operations.
• Employs Pydantic models for type safety.
• Implements robust error handling.

Installation

1. Clone the repository.
2. Set up a virtual environment, activate it, and install the project dependencies using pip install -e ..
3. Create a .env file in the project root and add your Notion API key.

Usage

1. Run python -m notion_mcp to test the server.
2. To use with Claude Desktop, configure the claude_desktop_config.json file with the correct paths to your virtual environment and project directory.

Development

The project structure is detailed in the README.

Running Tests

Use pytest to execute the test suite.

Configuration

Obtain a Notion integration token from Notion's "My Integrations" page and add it to the .env file.

Contributing

Fork the repository, create a feature branch, commit changes, push the branch, and open a pull request.

License

MIT License.

Acknowledgments

Built for Claude Desktop, utilizes Notion's API, and acknowledges [danhilse]'s [notion-mcp-server] project as a reference.