Notion MCP Server

by flyer103

213 downloads
Not rated
GitHub

About

Notion MCP Server implements the Model Context Protocol to interface with Notion’s API, enabling AI models to read and write Notion documents and data. It is built with the official MCP Python SDK and is intended for use with MCP‑compatible LLM clients like Claude for Desktop.

Details

Author
flyer103
Downloads
213
Categories
Knowledge Base

- Supports 14 tools for pages, databases, blocks, comments, and search.
- Two transport methods: stdio (default) and SSE.
- Configured via a single environment variable (NOTION_API_KEY).
- Requires Python 3.12+ and the uv package manager.
- Seamlessly integrates with Claude for Desktop through a JSON config file.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Notion MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, create a virtual environment, and install dependencies with uv. Obtain a Notion API key from the Notion integrations page and set it as the NOTION_API_KEY environment variable. Run python -m notion_mcp.server (stdio) or use --transport sse for SSE. For Claude for Desktop, add a claude_desktop_config.json file pointing to the uv executable and the server directory.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "notion mcp server": {
            "notion-mcp-flyer103": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

McpServers

{
    "notion-mcp-flyer103": {
        "command": "uv",
        "args": [
            "venv"
        ]
    }
}

Notion MCP Server

A Model Context Protocol (MCP) server for interacting with Notion APIs.

Overview

This project implements an MCP server that interfaces with Notion's API, allowing AI models to interact with Notion documents and data. It follows the Model Context Protocol specification and uses the official MCP Python SDK.

Requirements

- Python 3.12 or higher
- uv for package management

Installation

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.