Notion Markdown

🚀 NotionMCP Light 日本語版

NotionMCP Lightは、Notion APIを使用してMarkdownファイルとNotionページを同期するModel Context Protocol (MCP) サーバーです。このサーバーは、Markdownコンテンツの同期を効率的に行い、ユーザーに便利な体験を提供します。

🚀 クイックスタート

NotionMCP Lightは、公式のNotion MCPサーバーがMarkdownコンテンツを処理する際の非効率性（ブロック単位での読み書きやLLMトークンの消費）を解決するために開発された非公式のMCPサーバーです。APIを通じて、MarkdownファイルとNotionページまたはデータベースの同期をトークンを使用せずに直接行うことができます。

✨ 主な機能

• Markdown → Notion

  • H1見出しをページタイトルとして認識します。
  • Markdownコンテンツを新しいNotionページまたはデータベースエントリとして作成します。
  • ターゲットデータベースIDを指定できます。
  • Notion APIを直接呼び出します（トークン不要）。

• Notion → Markdown

  • 指定されたページまたはデータベースエントリをMarkdown形式に変換します。
  • 出力時に見出しをH1として処理します。
  • ブロック構造をMarkdown形式に変換します。
  • ファイル保存機能を備えています。

• MCPサーバー互換性

  • Model Context Protocol (MCP) 規格に準拠しています。
  • AIツール（Cursor、Clineなど）からの呼び出しをサポートしています。
  • stdioベースのJSON - RPCで実装されています。

📦 インストール

依存関係のインストール

# もしuvがインストールされていない場合は、まずインストールしてください
# pip install uv

# 依存関係をインストールします
uv sync

Notion APIトークンの設定

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 ファイルに以下の内容を追加します。

"notion-mcp-light": {
  "command": "uv",
  "args": [
    "run",
    "--directory",
    "/path/to/notion-mcp-light",
    "python",
    "-m",
    "src.main"
  ],
  "env": {
    "NOTION_TOKEN": "your_notion_api_token"
  },
  "disabled": false,
  "alwaysAllow": []
}

/path/to/notion-mcp-light をNotionMCP Lightの実際のインストールパスに置き換えてください。

uploadMarkdown

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

{
  "jsonrpc": "2.0",
  "method": "uploadMarkdown",
  "params": {
    "filepath": "path/to/markdown.md"
  }
}