Notion Universal MCP Server
Provides tools for interacting with Notion's API, enabling AI agents to manage pages, databases, and other Notion resources.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Notion Universal MCP Servercreate a new page in my project database"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Notion Universal MCP Server
This repository contains an implementation of an Notion Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Notion's tools and services through a unified API.
The server is built using the Universal MCP framework.
This implementation follows the MCP specification, ensuring compatibility with other MCP-compliant services and tools.
Usage
You can start using Notion directly from agentr.dev. Visit agentr.dev/apps and enable Notion.
If you have not used universal mcp before follow the setup instructions at agentr.dev/quickstart
Related MCP server: Contentful Universal MCP Server
Available Tools
The full list of available tools is at ./src/universal_mcp_notion/README.md
Local Development
š Prerequisites
Ensure you have the following before you begin:
Python 3.11+ (recommended)
uv (install globally with
pip install uv)
š ļø Setup Instructions
Follow the steps below to set up your development environment:
Sync Project Dependencies
uv syncThis installs all dependencies from
pyproject.tomlinto a local virtual environment (.venv).Activate the Virtual Environment
For Linux/macOS:
source .venv/bin/activateFor Windows (PowerShell):
.venv\Scripts\ActivateStart the MCP Inspector
mcp dev src/universal_mcp_notion/server.pyThis will start the MCP inspector. Make note of the address and port shown in the console output.
Install the Application
mcp install src/universal_mcp_notion/server.py
š Project Structure
.
āāā src/
ā āāā universal_mcp_notion/
ā āāā __init__.py # Package initializer
ā āāā server.py # Server entry point
ā āāā app.py # Application tools
ā āāā README.md # List of application tools
āāā tests/ # Test suite
āāā .env # Environment variables for local development
āāā pyproject.toml # Project configuration
āāā README.md # This fileš License
This project is licensed under the MIT License.
Generated with MCP CLI ā Happy coding! š
This server cannot be deployed
Maintenance
Related MCP Connectors
Access and maintain design system docs, tokens, components, skills, and contexts across any project.
- cmsOAuthcom.writavo
Draft, edit, organise, schedule and publish a Writavo Site's content from any AI assistant.
Manage WordPress blogs and WooCommerce shops from Claude, ChatGPT, Cursor and other MCP apps.
No-code databases, forms, portals and AI sites. Manage records and automation via natural language.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Language Models to interact with Notion workspaces through standardized tools for searching, reading, creating, and updating pages and databases.119MIT
- AlicenseNot gradedqualityDmaintenanceProvides a standardized interface for interacting with Contentful's tools and services through a unified API. Enables content management and site configuration via natural language.1MIT
- AlicenseCqualityCmaintenanceProvides full CRUD capabilities over Notion pages, databases, and content blocks, enabling natural language search, creation, and modification of Notion data.7MIT
- AlicenseNot gradedqualityAmaintenanceGives AI clients token-authenticated read/write access to Notion, letting them create and rewrite pages, query databases, append blocks, apply templates, comment, and upload files through natural language. It exposes 47 operations behind only three tools to keep context usage small, and runs headless with batched mutations, idempotency keys, and retry on rate limits.4,756 npmMIT