Notion Markdown

by karaage0703

27 stars

Not rated

GitHub

About

Integrates with Notion to provide simplified access to workspace content through Markdown conversion for easy retrieval and manipulation of databases and pages.

Details

Author: karaage0703
Repository: karaage0703/notion-mcp-light
GitHub stars: 27
License: MIT License
Categories: Developer Tools, Design, Workplace, AI, Search, Security, API, Database
Tags: #integration

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:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Notion Markdown

Command (node, npx, python, etc.) uv
Arguments
- Argument 1 run
- Argument 2 --directory
- Argument 3 /path/to/notion-mcp-light
- Argument 4 -m
- Argument 5 src.main
Environment
- NOTION_TOKEN your_notion_api_token
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

`uploadMarkdown`

Upload a Markdown file and create it as a Notion page. Parameters: filepath (string), database_id (optional string), page_id (optional string)

`downloadMarkdown`

Download a Notion page and save it as a Markdown file. Parameters: page_id (string), output_path (string)

Claude Desktop / Cursor

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

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

Linux

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

Macos

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

Windows

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

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/Claude CodeなどのAIコーディングツールでNotionMCP Lightを使用するには、各ツールのMCPサーバ設定を行うJSONファイルに以下のような設定を追加します：

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

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

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ファイルを参照してください。

No reviews yet — be the first

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

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

uploadMarkdown

downloadMarkdown

Claude Desktop / Cursor

Linux

Macos

Windows

NotionMCP Light

概要

機能

インストール

依存関係のインストール

pip install uv

依存関係のインストール

Notion API Tokenの設定

使い方

MCPサーバーの起動

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

通常のPythonを使用する場合

Cline/Cursorでの設定

MCPツールの使用方法

uploadMarkdown

downloadMarkdown

ライセンス

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright

`uploadMarkdown`

`downloadMarkdown`