Notion Chakra MCP

🚀 Notion Chakra MCP

This is a service integrated into Notion, providing MCP (Message Control Protocol) endpoints for interacting with Notion databases and pages.

🚀 Quick Start

✨ Features

• List and query Notion databases.
• Create and update pages.
• Search Notion content.
• Manage blocks and sub - items.
• Support stdio and SSE transmissions.

📦 Installation

1. MCP Client Configuration (Recommended)

Add the following content to your ~/.cursor/mcp.json:

{
  "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"
      }
    }
  }
}

Please ensure:

1. Replace /path/to/notion-chakra-mcp with your actual project path.
2. Set your NOTION_API_KEY value.
3. Create a data directory in the project root: mkdir -p data.

2. Docker Compose Setup

For development or standalone use:

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

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

3. Direct Docker Usage

For manual testing or custom settings:

# 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

📚 Documentation

Configuration

Development

Run Tests

# Install test dependencies
pip install -r requirements.txt

# Run tests
python -m pytest tests/ -v

Add New Features

1. Add your feature implementation in src/.
2. Add tests in tests/.
3. Update requirements.txt if necessary.
4. Run tests to verify that everything works properly.