makenotion/notion-mcp-server

What it solves

This project provides a way for AI agents to interact with Notion workspaces. It allows LLMs to search, read, and edit Notion pages and databases by implementing the Model Context Protocol (MCP), turning the Notion API into a set of tools that an AI client can discover and use automatically.

How it works

The server acts as a bridge between an MCP-compatible AI client (like Claude Desktop or Cursor) and the Notion API. It exposes 22 different tools that the AI can use to perform actions such as querying data sources, retrieving page metadata, and moving pages. To improve token efficiency, it includes specialized tools that allow the AI to read and write page content using Markdown instead of the complex JSON block format typically used by the Notion API.

Who it’s for

Developers and AI power users who want to self-host a connection between their Notion workspace and their AI agents, and who are comfortable managing their own API tokens and local server configurations.

Highlights

• Markdown Support: Includes specific tools for reading and editing pages in Markdown to reduce token usage.
• Flexible Transport: Supports both standard input/output (STDIO) and Streamable HTTP transport for web-based applications.
• Multi-tenant Capability: Can be configured with token passthrough to serve multiple Notion integrations from a single deployment.
• Broad Toolset: Provides 22 tools covering page management, database (data source) queries, and content manipulation.