mcp-registry/suekou/mcp-notion-server

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

suekou/mcp-notion-server

by suekou

Node-based MCP server that lets LLMs read/write Notion workspaces via the Notion API; supports optional Markdown conversion to shrink token usage.

787
134
Open Source
GitHubNPM

Installation

1. Prerequisites
• Node.js ≥18 and npm (or pnpm/yarn)
• A Notion integration token with access to the pages/databases you want the MCP server to read/write.
• (Optional) MCP platform API key if your deployment is gated.
2. Clone or install via npm
# clone the repository git clone https://github.com/suekou/mcp-notion-server.git cd mcp-notion-server # install dependencies npm install # or pnpm install / yarn # OR consume as a library / CLI npm i mcp-notion-server --save
3. Configure environment variables (create .env or export vars)
NOTION_TOKEN="secret_xxx" # Notion internal integration token NOTION_DATABASE_ID="xxxxxxxx" # Default database (optional) MCP_PORT=3000 # Port the server will listen on (default 3000) MCP_HOST=0.0.0.0 # Host binding MCP_API_KEY="<optional-key>" # If auth required by your MCP gateway
4. Build (TypeScript → JS)
npm run build # usually tsc or next-build script
5. Run the server in production
npm start # often an alias for node dist/index.js
6. Development hot-reload
npm run dev # nodemon / ts-node
7. Docker (if provided)
docker build -t mcp-notion-server . docker run -p 3000:3000 --env-file .env mcp-notion-server

Documentation

License: MIT License
Updated 7/15/2025
suekou/mcp-notion-server - MCP Server Registry - Augment Code