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の設定
- Notion Developersでアカウントを作成し、APIトークンを取得します。
- 環境変数に設定するか、
.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ファイルを参照してください。
Metadata
Release files for iflow-mcp_notion-mcp-light 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_notion_mcp_light-0.1.0.tar.gz | 3.9 kB | Without provenance | Details for iflow_mcp_notion_mcp_light-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_notion_mcp_light-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_notion_mcp_light-0.1.0-py3-none-any.whl |
Total release size: 8.1 kB
Release files / iflow_mcp_notion_mcp_light-0.1.0.tar.gz
| Download URL | iflow_mcp_notion_mcp_light-0.1.0.tar.gz |
|---|---|
| Size | 3.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8fe824dbc89d802b9f253e8b5c36917158a6e070f444bbd0fe44008ca9dcaa9e
|
|
BLAKE2b-256 checksum How to use checksums |
49618871a9e6a9b291d74951087c345e1a82b8f5dc99edf5dcfffcbcda525b1b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.6.9
|
Release files / iflow_mcp_notion_mcp_light-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_notion_mcp_light-0.1.0-py3-none-any.whl |
|---|---|
| Size | 4.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ec004502ef4c5c02e2045c30c5f7046f5cbd1421f2d09ea79b4b313f7034e54c
|
|
BLAKE2b-256 checksum How to use checksums |
bfbce4943d8bb20887b42157962db4c69bf4e2fb3c33e550306eb4e28b0195eb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.6.9
|
Security for iflow-mcp_notion-mcp-light 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.