Skip to main content
Glama
universal-mcp

Notion Universal MCP Server

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:

  1. Sync Project Dependencies

    uv sync

    This installs all dependencies from pyproject.toml into a local virtual environment (.venv).

  2. Activate the Virtual Environment

    For Linux/macOS:

    source .venv/bin/activate

    For Windows (PowerShell):

    .venv\Scripts\Activate
  3. Start the MCP Inspector

    mcp dev src/universal_mcp_notion/server.py

    This will start the MCP inspector. Make note of the address and port shown in the console output.

  4. 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! šŸš€

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    A
    maintenance
    Gives 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 npm
    MIT