Integrations
Provides a standardized interface for interacting with Notion's API, allowing users to list and query databases, create and update pages, and search across a Notion workspace.
Notion MCP Server
A Model Context Protocol (MCP) server implementation for Notion integration, providing a standardized interface for interacting with Notion's API. Compatible with Claude Desktop and other MCP clients.
Features
- List and query Notion databases
- Create and update pages
- Search across Notion workspace
- Get database details and block children
- Full async/await support with httpx
- Type-safe with Pydantic v2 models
- Proper error handling with detailed logging
- Compatibility with MCP 1.6.0
Installation
- Clone the repository:
- Create a virtual environment and install dependencies (using uv):
Alternatively, using standard venv:
- Create a
.env
file in the project root:
Usage
- Test the server (it should run without errors):
- To use it with Claude Desktop, adjust your
claude_desktop_config.json
file (located at~/Library/Application Support/Claude/claude_desktop_config.json
on macOS):
Be sure to replace /Users/username/
with your actual home directory path.
Development
Project Structure
Running Tests
Configuration
The server requires a Notion integration token. To set this up:
- Go to https://www.notion.so/my-integrations
- Create a new integration with appropriate capabilities (read/write as needed)
- Copy the integration token
- Add it to your
.env
file in the project root directory:
- Share your Notion databases with the integration (from the database's "Share" menu)
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
Troubleshooting
Common Issues
- Connection Errors: Make sure your Notion API key is correct and you have internet access
- Permission Errors: Ensure your integration has been given access to the databases you're trying to access
- Claude Desktop Integration: If Claude Desktop isn't connecting, check that your config path is correct and that the server is running without logging to stdout
Acknowledgments
- Built to work with Claude Desktop and other MCP clients
- Uses Notion's API (latest compatible version 2022-02-22)
- MCP 1.6.0 compatibility maintained
- Special thanks to danhilse, I referenced his notion-mcp-server project
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that provides a standardized interface for interacting with Notion's API, enabling users to list databases, create pages, and search across their Notion workspace.
Related Resources
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.Last updated -3PythonMIT License
- -securityFlicense-qualityA Model Context Protocol server that enables Claude and other LLMs to interact with Notion workspaces, providing capabilities like searching, retrieving, creating and updating pages, as well as managing databases.Last updated -2752TypeScript
- -securityFlicense-qualityA Model Context Protocol server that provides a comprehensive interface for interacting with the ConnectWise Manage API, simplifying API discovery, execution, and management for both developers and AI assistants.Last updated -462Python
- -securityFlicense-qualityA Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.Last updated -275JavaScript