Better Notion MCP

🚀 Better Notion MCP

Notion用のMarkdown優先MCPサーバー - AIエージェント向けに最適化

🤔 なぜ「Better」なのか？

Notionの28以上のREST APIエンドポイントをAIエージェント向けに最適化された複合操作に統合する7つの巨大なアクションベースのツールがあります。

公式のNotion MCPサーバーとの比較

📦 インストール

Notionトークンを取得します：https://www.notion.so/my-integrations → 統合を作成 → トークンをコピー → 統合とページを共有

クイックスタート

NPX (推奨)

{
  "mcpServers": {
    "better-notion": {
      "command": "npx",
      "args": ["-y", "@n24q02m/better-notion-mcp@latest"],
      "env": {
        "NOTION_TOKEN": "your_token_here"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "better-notion": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "NOTION_TOKEN", "n24q02m/better-notion-mcp:latest"],
      "env": {
        "NOTION_TOKEN": "your_token_here"
      }
    }
  }
}

💻 ツールの概要

30以上のアクションを持つ7つの巨大なツール：

• 複合アクション：操作を組み合わせる (例: 1回の呼び出しでページ + コンテンツ + プロパティを作成)
• 自動ページネーション：大規模なデータセットを透過的に処理
• 一括操作：複数のアイテムを効率的に処理
• スマート検索：データベースクエリで最適なマッチを自動検出

⚠️ 制限事項

サポートされるブロックタイプ (Markdown変換)：

• ✅ 見出し (H1 - H3)、段落、リスト (箇条書き/番号付き)
• ✅ コードブロック、引用、区切り線
• ✅ インライン形式 (太字、斜体、コード、取り消し線、リンク)

サポートされないブロックタイプ：

• ❌ テーブル、トグル、コールアウト、カラム
• ❌ データベース、埋め込み、画像、ファイル
• ❌ 同期ブロック、テンプレート

ソースからビルド

このプロジェクトはツールのバージョン管理にmiseを使用しています。miseがインストールされていない場合は、mise.jdx.devを参照してください。

git clone https://github.com/n24q02m/better-notion-mcp
cd better-notion-mcp

mise trust
mise install

pnpm install
pnpm build

uv venv
uv pip install pre-commit
uv run pre-commit install
uv run pre-commit run --all-file

前提条件：miseまたはNode.js 22+とpnpm。

利用可能なコマンド

pnpm dev                    # 自動リロードで開発サーバーを実行
pnpm build                  # プロジェクトをビルド
pnpm test                   # テストを実行
pnpm test:watch             # ウォッチモードでテストを実行
pnpm test:coverage          # カバレッジレポート付きでテストを実行
pnpm check                  # フォーマット、リント、型チェック (Biome + TypeScript)
pnpm check:fix              # フォーマットとリントの問題を自動修正

🤝 コントリビューション

コントリビューションを歓迎します！CONTRIBUTING.mdを参照してください：

• 開発ワークフロー (CIで検証)
• コミット規約 (gitフックで強制)
• テストとコード品質標準

📄 ライセンス

MITライセンス - LICENSEを参照

このリポジトリが役に立ったらスターをつけてください！ ⭐