What is Notion Mcp Light

NotionMCP Light is an unofficial Model Context Protocol (MCP) server that synchronizes Markdown files with Notion pages using the Notion API without requiring token usage. It addresses inefficiencies in the official MCP server by allowing direct synchronization without consuming LLM tokens.

Use cases

Use cases include uploading Markdown files to Notion as pages, converting Notion pages back to Markdown format for offline editing, and integrating with AI tools for enhanced productivity in managing content.

How to use

To use NotionMCP Light, first install the necessary dependencies and set up your Notion API token in an environment variable or a .env file. Start the MCP server using the command ‘uv run python -m src.main’. You can also configure it for use with AI tools like Cline or Cursor by adding specific settings in the ‘mcp_settings.json’ file.

Key features

Key features include the ability to convert Markdown to Notion pages, convert Notion pages to Markdown, support for specifying database IDs, and compliance with the Model Context Protocol (MCP). It operates over JSON-RPC and provides endpoints callable from AI tools.

Where to use

NotionMCP Light can be used in various fields such as content creation, documentation management, and project collaboration, where Markdown and Notion are utilized for organizing information.

NotionMCP Light

NotionMCP Lightは、Notion APIを使用してMarkdownファイルとNotionページを同期するModel Context Protocol (MCP)サーバーです。

概要

このプロジェクトは、Notionの公式Model Context Protocol (MCP)サーバーが抱える非効率性（Markdownをブロック単位で読み書きし、LLMトークンを消費する点）を解決するために開発されました。トークンを使用せず、API経由で直接MarkdownファイルとNotionのページ／データベースを同期できる非公式のMCPサーバーを提供します。

機能

• Markdown → Notion

  • H1をページタイトルとして認識
  • Markdownの内容をNotionページまたはデータベースのページとして作成
  • データベースIDを指定可能
  • Notion APIを直接使用（トークン未使用）

• Notion → Markdown

  • 指定されたページまたはデータベースのページをMarkdown形式に変換
  • タイトルをH1として出力
  • ブロック構造をMarkdownに変換
  • ファイルに保存

• MCPサーバー対応

  • Model Context Protocol（MCP）に準拠
  • CursorやClineなどのAIツールから呼び出し可能なエンドポイントを提供
  • JSON-RPC over stdioベースで動作

インストール

依存関係のインストール

# uvがインストールされていない場合は先にインストール
# pip install uv

# 依存関係のインストール
uv sync

Notion API Tokenの設定

1. Notion Developersでアカウントを作成し、APIトークンを取得します。
2. 環境変数に設定するか、.envファイルを作成してトークンを設定します。

# .envファイルの例
NOTION_TOKEN=your_notion_api_token

使い方

MCPサーバーの起動

uvを使用する場合（推奨）

uv run python -m src.main

または、トークンを直接指定する場合：

uv run python -m src.main --token your_notion_api_token

通常のPythonを使用する場合

python -m src.main

または、トークンを直接指定する場合：

python -m src.main --token your_notion_api_token

Cline/Cursorでの設定

Cline/CursorなどのAIツールでNotionMCP Lightを使用するには、mcp_settings.jsonファイルに以下のような設定を追加します：

/path/to/notion-mcp-lightは、NotionMCP Lightのインストールディレクトリに置き換えてください。

MCPツールの使用方法

NotionMCP Lightは以下のMCPツールを提供します：

uploadMarkdown

Markdownファイルをアップロードし、Notionページとして作成します。

{
  "jsonrpc": "2.0",
  "method": "uploadMarkdown",
  "params": {
    "filepath": "path/to/markdown.md",
    "database_id": "optional_database_id",
    "page_id": "optional_parent_page_id"
  },
  "id": 1
}

downloadMarkdown

NotionページをダウンロードしてMarkdownファイルとして保存します。

{
  "jsonrpc": "2.0",
  "method": "downloadMarkdown",
  "params": {
    "page_id": "notion_page_id",
    "output_path": "path/to/output.md"
  },
  "id": 2
}

ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。