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

# Transform Augment Code into Your Notion-Powered Development Hub

The **MCP Notion Server** turns Augment Code into a powerful workspace orchestrator that can read, write, and manage your entire development workflow directly in Notion. Instead of switching between your editor and Notion to update documentation, track issues, or manage project notes, Augment can now handle it all seamlessly while you code.

## Supercharge Your Development Workflow

With this MCP server connected to Augment Code, you can ask your AI assistant to query your sprint database, update technical documentation, create issue tracking pages, or search through your team's knowledge base—all without leaving your coding environment. Augment becomes your intelligent bridge between code and documentation, automatically updating project wikis when you implement new features, creating database entries for bugs you discover, or pulling context from your technical decision records when reviewing code.

The server's smart Markdown conversion feature significantly reduces token usage while maintaining full readability, making it perfect for developers who want Augment to work with large Notion workspaces efficiently. Whether you're building API documentation from code comments, tracking feature development progress, or maintaining team runbooks, this integration transforms Augment from a coding assistant into a comprehensive development workflow manager.

## Setup with Augment Code

Add this configuration to your Augment Code settings:

```json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@suekou/mcp-notion-server"],
      "env": {
        "NOTION_API_TOKEN": "your-notion-integration-token",
        "NOTION_MARKDOWN_CONVERSION": "true"
      }
    }
  }
}
```

Now Augment can help you create database entries for new features, update documentation pages when you refactor code, search through your technical knowledge base for implementation guidance, and maintain your development workflow without missing a beat.
License: MIT License
Updated 7/15/2025

Table of Contents