mcp-registry/mcp-notion-server

    ==================
      
       /// MCP ///
      /// MCP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mcp-notion-server

by suekou

MCP Server that lets LLMs interact with Notion workspaces. Includes optional Markdown-conversion to minimise token usage.

799
133
Open Source
GitHubNPM

Installation

1. Prerequisites
• Node.js ≥ 18 and npm (or pnpm/yarn)
• A Notion integration token with access to the pages / database you want to expose
2. Clone or install
# Option A – use as CLI/server package npm install --global mcp-notion-server # or npx mcp-notion-server init # scaffolds a local project # Option B – run from source git clone https://github.com/suekou/mcp-notion-server.git cd mcp-notion-server npm install # installs deps npm run build # compiles TypeScript
3. Configure environment
Create a .env file (or export vars) with at minimum: NOTION_API_TOKEN=secret_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX NOTION_ROOT_PAGE=<page-id-or-database-id> PORT=3000 # optional, default 3000
4. Run the server
npm run start # production build # or for development with automatic reload npm run dev
5. Verify
Open http://localhost:3000/_health – should return {"status":"ok"} Your MCP endpoint is now available at http://localhost:3000/mcp

Documentation

License: MIT License
Updated 7/30/2025

Table of Contents