notion-chakra-mcp

Notion Chakra MCP is a robust integration service designed to facilitate seamless interaction with Notion databases and pages through Message Control Protocol (MCP) endpoints. It allows users to list, query, create, and update Notion content efficiently. The service supports both standard input/output (stdio) and Server-Sent Events (SSE) transports, making it versatile for various use cases. Users can manage blocks and their children, search content, and perform other operations on Notion data. The service is containerized, allowing for easy deployment and management using Docker or Docker Compose. It requires a Notion API key for authentication and supports persistent data storage through a designated data directory.

Features

• List and query Notion databases
• Create and update pages
• Search Notion content
• Manage blocks and children
• Support for both stdio and SSE transports

Usage with Different Platforms

MCP Client Configuration

{
  "mcpServers": {
    "notion-chakra-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/path/to/notion-chakra-mcp/data:/app/data",
        "-e",
        "TRANSPORT",
        "-e",
        "NOTION_API_KEY",
        "-e",
        "HOST",
        "-e",
        "PORT",
        "-e",
        "PYTHONPATH=/app/src",
        "notion-chakra-mcp"
      ],
      "env": {
        "TRANSPORT": "stdio",
        "NOTION_API_KEY": "your_notion_api_key",
        "HOST": "0.0.0.0",
        "PORT": "8050"
      }
    }
  }
}

Docker Compose Setup

bash
# Build and start with stdio transport
TRANSPORT=stdio docker-compose up notion-chakra-mcp

# Or with SSE transport
TRANSPORT=sse docker-compose up notion-chakra-mcp

Direct Docker Usage

bash
# Build the image
docker build -t notion-chakra-mcp .

# Run with stdio transport
docker run --rm -i \
  -v $(pwd)/data:/app/data \
  -e TRANSPORT=stdio \
  -e NOTION_API_KEY=your_key \
  -e PYTHONPATH=/app/src \
  notion-chakra-mcp

# Run with SSE transport
docker run --rm -i \
  -v $(pwd)/data:/app/data \
  -e TRANSPORT=sse \
  -e NOTION_API_KEY=your_key \
  -e HOST=0.0.0.0 \
  -e PORT=8050 \
  -p 8050:8050 \
  -e PYTHONPATH=/app/src \
  notion-chakra-mcp