suekou/mcp-notion-server
Author: suekou
Description: Node-based MCP server that lets LLMs read/write Notion workspaces via the Notion API; supports optional Markdown conversion to shrink token usage.
Stars: 787
Forks: 134
License: MIT License
Category: Open Source
Overview
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 --save3. 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 gateway4. Build (TypeScript → JS)
npm run build # usually tsc or next-build script5. Run the server in production
npm start # often an alias for node dist/index.js6. Development hot-reload
npm run dev # nodemon / ts-node7. Docker (if provided)
docker build -t mcp-notion-server .
docker run -p 3000:3000 --env-file .env mcp-notion-serverLicense: MIT License
Updated 7/15/2025