Notion MCP Server is an MCP server that connects AI agents to the Notion API through the Model Context Protocol.
The tool solves the problem of enabling AI agents to interact with Notion workspaces by exposing Notion's capabilities as MCP tools. It handles authentication via OAuth, eliminating the need for manual API token configuration. The server translates Notion API operations into tools that agents can call, with a focus on token efficiency by supporting Markdown-based page content editing rather than block-level JSON structures.
Developers should be aware that Notion has introduced a remote MCP server as the primary offering, and this local repository is no longer actively maintained. The README explicitly states that issues and pull requests are not actively monitored and that this repository may be sunset in the future. Developers should use the remote Notion MCP instead, which provides easier installation and active support. This local server is suitable only for those with specific reasons to run an MCP server locally and who can maintain it independently.
The project underwent a major breaking change in version 2.0.0, migrating to the Notion API's data sources abstraction and replacing three database-focused tools with seven new data source and page management tools. Tool discovery is automatic, so AI clients adapt to the new tool set without manual reconfiguration, though any hardcoded references to old tool names require updates. The server exposes twenty-two total tools for querying data sources, managing pages, and retrieving metadata.
