notion-export-mcp-server
Allows exporting Notion pages to markdown using Notion's unofficial API, enabling retrieval of page content as markdown text.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@notion-export-mcp-server Export my Notion page 'Project Roadmap' as markdown"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
notion-export-mcp-server
A MCP(Model Context Protocol) server that accesses to Notion unofficial API to export pages.
This server provides MCP-compatible access to Notion's unofficial API, allowing AI assistants to interact with your Notion exported page data through a standardized interface.
Features
Available tools:
notion_export_get_result- Get notion export result markdown text
Related MCP server: notion-mcp-server
Quick Start
Installation
Manual Installation
npm install notion-export-mcp-serverConfiguration
NOTION_TOKEN_V2: Your Notion tokenNOTION_FILE_TOKEN: Your Notion file token
Usage
Start the MCP server
Directly:
npx notion-export-mcp-serverOr, run the installed module with node.
Edit MCP configuration json for your client:
...
"notion-export": {
"command": "npx",
"args": [
"-y",
"notion-export-mcp-server"
],
"env": {
"NOTION_TOKEN_V2": "<your token>",
"NOTION_FILE_TOKEN": "<your token>"
}
},
...Secrets?
How to get
To export anything from Notion, one needs to authenticate oneself with some Cookies (like a browser would). These cookies are called token_v2 and file_token. They are set on all requests of a logged in user when using the Notion web-app.
Go to notion.so.
Log in with your account.
Open the developer tools of your browser, open Application > Storage > Cookies (Chrome); Storage tab (Firefox).
Copy the value of the Cookies called
token_v2andfile_tokenand paste them somewhere safe.⚠️ If you don't find file_token, you need to have at least had exported a file manually once.
Those cookies have a 1 year validity, so you don't need to do this often.
Note on Stability
This tool completely relies on the export/download feature of the official but internal Notion.so API. The advantage is, that we do not generate any markup ourselves, just download and extract some ZIPs. While the download feature seems to be pretty stable, keep in mind that it still is an internal API, so it may break anytime.
Development
Available Scripts
npm run dev- Start the server in development mode with hot reloadingnpm run build- Build the project for productionnpm run start- Start the production servernpm run lint- Run linting checks (ESLint and Prettier)npm run fix- Automatically fix linting issuesnpm run examples- Run the example scripts
Contributing
Fork the repository
Create your feature branch
Run tests and linting:
npm run lintCommit your changes
Push to the branch
Create a Pull Request
Available Tools
1 toolnotion_export_get_resultC
Get notion export result
Inputs: id (required), recursive.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of overlap or confusion. The tool's purpose is clearly stated as retrieving a Notion export result.
The single tool name follows a clear verb_noun pattern (get_result) with a domain prefix (notion_export). No inconsistencies exist in the set.
One tool is too few for a server dedicated to Notion exports. Typical export workflows require initiating an export, listing exports, and retrieving results, so the current count is insufficient for the apparent scope.
The server only supports retrieving an export result, missing essential operations like creating an export or checking export status. This severely limits the tool's usability and leaves the workflow incomplete.
Related MCP Connectors
Turn any web page into clean Markdown for your AI assistant. OAuth sign-in, no API key.
Pages, crawls and URL batches as clean Markdown and JSON for AI agents, with an Evidence Record.
Web scraping for AI agents. Converts URLs to clean, LLM-ready Markdown with anti-bot bypass.
YouTube transcripts (chunks, phrase search, most replayed moments), PDFs and web pages as Markdown.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Notion through the Notion API by exposing it as tools for LLMs, allowing operations like reading, creating, updating, and deleting Notion pages seamlessly via natural language.13 npm21MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude Desktop to read and create Notion pages with markdown formatting support.599 npmMIT
- AlicenseCqualityDmaintenanceEnables natural language interaction with Notion workspace, including search, page/database management, markdown conversion, and productivity shortcuts.27MIT
- AlicenseNot gradedqualityDmaintenanceProvides AI assistants with secure access to Notion workspaces, enabling page management, search, block operations, and user management.5,456 npmMIT