Repolode
Submit
makenotion

makenotion/notion-mcp-server

A self-hosted MCP server that lets AI assistants read and edit Notion workspaces through the Notion API, now superseded by Notion's hosted Remote MCP.

Open-source alternative to:Notion AI

View on GitHub
Stars
4,671
Forks
638
Open issues
202
Last commit
30 days ago

What is it?

This project is an MCP (Model Context Protocol) server that wraps the Notion API, exposing Notion operations such as searching, reading and creating pages, querying databases and data sources, and adding comments as tools that AI clients like Claude Desktop, Cursor and Zed can call. It runs locally over stdio by default, or as a Streamable HTTP server with bearer token authentication. Access is controlled by a Notion internal integration token, and only pages explicitly connected to that integration are visible.

Version 2.0.0 moves to Notion API version 2025-09-03, where data sources replace databases as the main abstraction, and adds two tools for reading and editing page content as Markdown. The Notion MCP team states that this repository is no longer actively maintained and that its hosted Remote Notion MCP is the recommended option, with semantic search and OAuth. Setup for this version still requires creating an integration, sharing pages with it, and editing a JSON client config.

The server can be run via npx, Docker, or built from source with npm, and includes an optional token passthrough mode so one deployment can serve multiple Notion integrations.

Key features

  • 01Exposes Notion API operations as MCP tools for AI clients.
  • 02Supports stdio and Streamable HTTP transports.
  • 03Reads and edits page content as Markdown in version 2.0.0.
  • 04Works with data sources, including creating, updating and querying them.
  • 05Accepts a Notion integration token via NOTION_TOKEN or OPENAPI_MCP_HEADERS.
  • 06Offers optional per-request token passthrough for multiple integrations.

Use cases

  • Letting an AI assistant search and summarize pages in a Notion workspace.
  • Automating page creation or comments from natural-language instructions in an editor.
  • Building a self-hosted bridge between Notion and an internal AI agent.
  • Running a read-only integration to limit what an AI client can change.

Quick start

  1. 1

    Create an internal integration in Notion and copy its token

  2. 2

    Connect the pages you want to use to the integration

  3. 3

    Add the MCP config with npx to your client, using your NOTION_TOKEN

    npx -y @notionhq/notion-mcp-server

Things to know

  • Notion recommends its hosted Remote Notion MCP instead, and this repository is no longer actively maintained or supported.
  • Issues and pull requests are not actively monitored and the project may be sunset.
  • Search is keyword-only and page content tools are limited compared with the hosted version.
  • Requires manual integration token setup and page sharing.

Topics

#mcp#notion#notion-api#ai-agents#typescript#llm-tools#self-hosted

FAQ

What is notion-mcp-server?
A self-hosted MCP server that lets AI assistants read and edit Notion workspaces through the Notion API, now superseded by Notion's hosted Remote MCP. This project is an MCP (Model Context Protocol) server that wraps the Notion API, exposing Notion operations such as searching, reading and creating pages, querying databases and data sources, and adding comments as tools that AI clients like Claude Desktop, Cursor and Zed can call. It runs locally over stdio by default, or as a Streamable HTTP server with bearer token authentication. Access is controlled by a Notion internal integration token, and only pages explicitly connected to that integration are visible.
Is notion-mcp-server free to use? What license does it have?
notion-mcp-server is open source under the MIT license. Check the license terms before using it in commercial products.
Is notion-mcp-server still maintained?
Actively maintained. The last commit to notion-mcp-server was on Sep 20, 2026.
What can I use notion-mcp-server for?
Letting an AI assistant search and summarize pages in a Notion workspace. Automating page creation or comments from natural-language instructions in an editor. Building a self-hosted bridge between Notion and an internal AI agent. Running a read-only integration to limit what an AI client can change.
How do I install notion-mcp-server?
Create an internal integration in Notion and copy its token Connect the pages you want to use to the integration Add the MCP config with npx to your client, using your NOTION_TOKEN: npx -y @notionhq/notion-mcp-server
Where can I get notion-mcp-server?
The source code and installation instructions are on GitHub: https://github.com/makenotion/notion-mcp-server

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects