Notion Chakra MCP

What is Notion Chakra MCP?

Notion Chakra MCP is a Notion integration service that provides MCP (Message Control Protocol) endpoints for interacting with Notion databases and pages. It supports both stdio and SSE transports and is intended for developers using MCP clients like Cursor.

How to use Notion Chakra MCP?

Configure Notion Chakra MCP as an MCP server in your client’s mcp.json (e.g., ~/.cursor/mcp.json), using a Docker container. Set the NOTION_API_KEY environment variable and optionally choose stdio or sse transport. Alternatively, use Docker Compose or direct Docker commands. A data directory must exist for persistence.

Key features of Notion Chakra MCP

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

Use cases of Notion Chakra MCP

• Query Notion databases programmatically via MCP tools
• Create or update pages in Notion from an MCP client
• Search across Notion workspaces
• Manage hierarchical block content

FAQ from Notion Chakra MCP

What environment variables are required?

NOTION_API_KEY is required. Optional variables include TRANSPORT (stdio or sse), HOST, PORT, and PYTHONPATH.

How can I choose between stdio and SSE transport?

Set the TRANSPORT environment variable to stdio or sse. The default is stdio.

How is data persisted?

A data directory must be mounted at /app/data inside the container. It stores schemas, database mappings, and other persistent data.

How do I run the tests?

Install test dependencies with pip install -r requirements.txt, then run python -m pytest tests/ -v.