Notion Export MCP Server

🚀 notion-export-mcp-server

このプロジェクトは、MCP（モデルコンテキストプロトコル）に基づくサーバーで、Notionの非公式APIにアクセスしてページをエクスポートします。

このサーバーはMCPと互換性のあるインターフェースを提供し、Notionの非公式APIにアクセスし、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

または、インストール済みのモジュールを使用して起動します。

クライアントのMCP設定jsonを変更する：

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

🔑 トークンについて

取得方法

Notionから何かをエクスポートするには、ログインしているユーザーと同じ認証を使用する必要があります。これらの認証はtoken_v2とfile_tokenと呼ばれ、ブラウザでNotionにアクセスするときに設定されるCookieです。

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

注意事項

このツールは完全にNotion.soの非公開で内部的なエクスポート機能に依存しています。利点は、マークを自動生成する必要がなく、ZIPファイルをダウンロードして抽出するだけで済むことです。ただし、これは内部APIであるため、いつでも変更または無効になる可能性があります。

🔧 開発

利用可能なスクリプト

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

コントリビューションガイド

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