This project provides an MCP (Meta-Cognitive Processing) server for the Notion API, enabling Large Language Models (LLMs) to interact with Notion workspaces. It targets developers and users who want to integrate LLMs with their Notion data, offering efficient token usage through optional Markdown conversion.

How It Works

The server acts as a bridge between an LLM agent (like Claude Desktop) and the Notion API. It exposes various Notion functionalities as tools that the LLM can call. A key feature is its experimental Markdown conversion, which transforms Notion content into Markdown format. This reduces the token count required to represent Notion data for LLMs, improving efficiency and potentially lowering costs, especially for large workspaces.

Quick Start & Requirements

• Install: npx @suekou/mcp-notion-server or build from source.
• Prerequisites: Node.js, npm/npx. A Notion integration token is required.
• Setup: Create a Notion integration, obtain a secret token, and add the integration to your Notion pages/databases. Configure claude_desktop_config.json with the server details.
• Docs: dev.to, qiita.com

Highlighted Details

• Supports a comprehensive set of Notion API operations, including block management, database querying, page updates, search, and comment handling.
• Offers an optional NOTION_MARKDOWN_CONVERSION feature to reduce LLM token consumption for read operations.
• Allows fine-grained control over tool availability via the --enabledTools command-line argument.
• Responses can be formatted as either JSON or Markdown, controllable per-request.

Maintenance & Community

The project is maintained by suekou. No specific community channels or roadmap links are provided in the README.

Licensing & Compatibility

Licensed under the MIT License, permitting commercial use and modification.

Limitations & Caveats

The Markdown conversion feature is experimental and may cause issues when editing page content due to potential loss of original structure. Listing and retrieving specific users requires an Enterprise plan and an Organization API key.