notion-export-mcp-server

notion-export-mcp-server

Notion の非公式 API にアクセスしてページをエクスポートする MCP（Model Context Protocol） サーバーです。

このサーバーは、Notion の非公式 API への MCP 互換アクセスを提供し、AI アシスタントが標準化されたインターフェースを通じて、エクスポートした Notion のページデータを操作できるようにします。

機能

利用可能なツール：

• notion_export_get_result - Notion のエクスポート結果を Markdown テキストで取得します

クイックスタート

インストール

手動インストール

npm install notion-export-mcp-server

設定

• NOTION_TOKEN_V2：Notion トークン
• NOTION_FILE_TOKEN：Notion ファイルトークン

使い方

MCP サーバーを起動する

直接起動する場合：

npx notion-export-mcp-server

または、インストールしたモジュールを node で実行します。

クライアントの MCP 設定 JSON を編集する：

...
    "notion-export": {
      "command": "npx",
      "args": [
        "-y",
        "notion-export-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN_V2": "<your token>",
        "NOTION_FILE_TOKEN": "<your token>"
      }
    },
...

シークレットについて

取得方法

Notion から何かをエクスポートするには、Cookie（ブラウザーの場合と同様）を使って認証する必要があります。これらの Cookie は token_v2 と file_token という名前で、Notion のウェブアプリを使用する際、ログイン済みユーザーのすべてのリクエストに設定されます。

1. notion.so にアクセスします。
2. アカウントにログインします。
3. ブラウザーの開発者ツールを開き、Application > Storage > Cookies（Chrome）または Storage タブ（Firefox）を開きます。
4. token_v2 と file_token という名前の Cookie の値をコピーし、安全な場所に貼り付けます。
   • ⚠️ file_token が見つからない場合は、少なくとも一度、手動でファイルをエクスポートする必要があります。
5. これらの Cookie の有効期間は 1 年なので、頻繁に行う必要はありません。

安定性に関する注意

このツールは、公式ではあるものの内部向けの Notion.so API が備えるエクスポート／ダウンロード機能に全面的に依存しています。利点は、独自にマークアップを生成せず、ZIP ファイルをダウンロードして展開するだけであることです。ダウンロード機能はかなり安定しているようですが、内部 API であるため、いつでも動作しなくなる可能性があることにご注意ください。

開発

利用可能なスクリプト

• npm run dev - ホットリロードを有効にして開発モードでサーバーを起動します
• npm run build - 本番環境向けにプロジェクトをビルドします
• npm run start - 本番サーバーを起動します
• npm run lint - lint チェック（ESLint と Prettier）を実行します
• npm run fix - lint の問題を自動的に修正します
• npm run examples - サンプルスクリプトを実行します

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. テストと lint を実行します：npm run lint
4. 変更をコミットします
5. ブランチにプッシュします
6. プルリクエストを作成します