notion-export-mcp-server
@syucream
A MCP server that accesses to Notion unofficial API to export pages.
Overview
What is notion-export-mcp-server?
notion-export-mcp-server is a Model Context Protocol (MCP) server that accesses Notion’s unofficial API to export pages, providing a standardized interface for AI assistants to interact with exported Notion page data.
How to use notion-export-mcp-server?
Install via npm (npm install notion-export-mcp-server), set the required environment variables NOTION_TOKEN_V2 and NOTION_FILE_TOKEN, then start the server with npx notion-export-mcp-server. Configure your MCP client with the command and environment variables shown in the README. The server exposes the tool notion_export_get_result to retrieve exported markdown.
Key features of notion-export-mcp-server
- Exports Notion pages via the unofficial API
- Returns page content as markdown text
- Works with any MCP-compatible client
- Uses cookies (token_v2, file_token) for authentication
- Relies on Notion’s internal export/download feature
Use cases of notion-export-mcp-server
- Export Notion pages for AI assistant consumption
- Integrate Notion document content into automated workflows
- Provide markdown access to Notion data without a paid API key
- Use within a MCP host for document retrieval tasks
FAQ from notion-export-mcp-server
How does notion-export-mcp-server differ from the official Notion API?
This server uses Notion’s internal, unofficial API for export, which does not require an official API key but relies on browser cookies. The official API may offer more features but is subject to different rate limits and authentication.
What are the runtime dependencies?
The server is a Node.js package and requires Node.js to be installed. It also needs the cookies token_v2 and file_token from a logged-in Notion session.
How do I obtain the required tokens?
Log into notion.so, open browser developer tools, go to Storage > Cookies, and copy the values of token_v2 and file_token. If file_token is missing, export a file manually from Notion first. These cookies are valid for about one year.
Where does the exported data come from?
The server downloads and extracts ZIP files from Notion’s internal export feature. It does not generate any markup itself; it simply retrieves the exported content.
Is the server stable?
The server relies on Notion’s internal API, which may break anytime. While the export feature has been relatively stable, there are no guarantees of ongoing availability.
