notion-mcp-light

notion-mcp-light

42
file_systemsknowledge_and_memory

NotionMCP Light is a server that facilitates the synchronization of Markdown files with Notion pages, addressing inefficiencies in the official Notion MCP server. It allows direct API integration without consuming tokens and supports JSON-RPC for communication with AI tools.

NotionMCP Light

NotionMCP Light is a Model Context Protocol (MCP) server that synchronizes Markdown files with Notion pages using the Notion API.

Features

  • Markdown → Notion

    • Recognizes H1 as page title and creates Notion page or database.
    • Option to specify database ID while using Notion API directly without token.

  • Notion → Markdown

    • Converts specified pages to Markdown format with title as H1 and saves files.

  • MCP Server Support

    • Compliant with Model Context Protocol (MCP) and provides endpoints for AI tools like Cursor and Cline.
    • Operates based on JSON-RPC over stdio.

Installation

  • Install dependencies and get a Notion API token from Notion Developers, then set it in environment variables or a .env file.

Usage

  • Start MCP server using uv run python -m src.main or configure AI tools with settings in mcp_settings.json.