Notion API MCP is an MCP server that connects AI assistants to Notion's API to manage task lists, databases, and workspace documentation. Built with Python using modern asynchronous libraries like httpx and Pydantic, the server is designed for individual users, project managers, and developers who rely on Notion as a central productivity workspace. It allows language models to create and update tasks with structured properties such as due dates, priority tiers, rich text descriptions, and nested subtasks. Beyond basic to-do lists, Notion API MCP enables AI agents to query and configure Notion databases using custom properties, filters, and views. It also provides tools to assemble and format long-form knowledge base articles and notes using Markdown and hierarchical block structures. By establishing a direct bridge between Notion and Model Context Protocol clients, the server helps users organize complex projects, capture unstructured agent outputs into structured tables, and maintain up-to-date tracking boards without manual interface entry.
Category: Notes & Knowledge Management
Tags: database, notion, productivity, task-management
Follow these steps to set up Notion API MCP with Claude Desktop: 1. Clone the repository and navigate into the directory: bash git clone https://github.com/pbohannon/notion-api-mcp.git cd notion-api-mcp 2. Create a virtual environment and install dependencies: bash uv venv && source .venv/bin/activate uv pip install -e . 3. Create an internal integration token at Notion's integration dashboard, then share your target page or database with the integration inside Notion. 4. Open Claude Desktop's configuration file (~/Library/Application Support/Claude/claude_desktop_config.json) and add the server definition: json { "mcpServers": { "notion-api": { "command": "/path/to/your/.venv/bin/python", "args": ["-m", "notion_api_mcp"], "env": { "NOTION_API_KEY": "ntn_your_integration_token_here", "NOTION_PARENT_PAGE_ID": "your_page_id_here", "NOTION_DATABASE_ID": "your_database_id_here" } } } } 5. Restart Claude Desktop to start using the tools.
Part of MCP Servers
Notion API MCP is a Model Context Protocol server written in Python that provides AI models with direct access to Notion through its official API. It allows AI assistants like Claude to manage to-do items, manipulate databases, and organize formatted workspace content using custom tools.
You need an internal integration token from Notion, starting with ntn, which serves as your NOTION_API_KEY. Depending on your workflow, you also need either a NOTION_PARENT_PAGE_ID for creating new databases or a NOTION_DATABASE_ID for interacting with an existing database.
You install Notion API MCP by cloning its Git repository, creating a Python virtual environment using uv, and installing the package locally with uv pip install -e dot. Once installed, point your MCP client to the virtual environment Python binary.
Notion API MCP works with any client that implements the Model Context Protocol standard over standard input and output. The project provides explicit setup instructions for Claude Desktop via its claude_desktop_config.json configuration file.