Repolode
Submit
suekou

suekou/mcp-notion-server

An MCP server that lets AI agents find, read, query, and edit Notion pages and databases through the Notion API.

View on GitHubWebsite
Stars
923
Forks
181
Open issues
10
Last commit
3 months ago

What is it?

This is a Model Context Protocol server that connects Notion workspaces to MCP-compatible clients such as Claude Desktop and Cursor. It targets the Notion API 2026-03-11 and works with the current database and data source model. Responses are kept compact, with stable block IDs for editing.

The server provides tools for searching and locating pages or data sources, reading page content, inspecting data source schemas, and querying or creating items using plain values. Simple editing tools cover paragraphs, headings, lists, todos, quotes, callouts, code blocks, dividers, and Markdown append. Raw Notion API tools are available for advanced block, page, database, comment, and user operations.

Setup requires creating an internal Notion integration, granting it read, insert, or update capabilities, and sharing the target pages or databases with it. The server runs via npx with a NOTION_API_TOKEN environment variable, and optional MCP Apps provide a Data Source Explorer and Page Workbench.

Key features

  • 01Finds pages and data sources by search with notion_find.
  • 02Reads pages in compact form with stable block IDs for editing.
  • 03Inspects data source schemas before querying or creating items.
  • 04Queries and creates data source items using simple values.
  • 05Edits pages with paragraphs, headings, lists, todos, code blocks, and Markdown append.
  • 06Provides raw Notion API tools for advanced block, database, comment, and user operations.

Use cases

  • Letting an AI assistant in Claude Desktop or Cursor read and summarize Notion notes.
  • Querying and adding entries to a Notion database from an agent workflow.
  • Automatically appending generated Markdown content to Notion pages.
  • Batch-updating page blocks with an AI-driven editing process.

Quick start

  1. 1

    Create a Notion internal integration and copy its token

  2. 2

    Add the server to your MCP host config with NOTION_API_TOKEN set

    npx -y @suekou/mcp-notion-server
  3. 3

    Restart your MCP host after saving the configuration

Things to know

  • Each Notion page or database must be explicitly shared with the integration before the server can access it.
  • Requires a Notion integration token and Node.js 22 or newer for development.

In collections

Open-source AI agent frameworks & appsMCP servers

Topics

#mcp#notion#ai-agents#model-context-protocol#notion-api#typescript#npm

FAQ

What is mcp-notion-server?
An MCP server that lets AI agents find, read, query, and edit Notion pages and databases through the Notion API. This is a Model Context Protocol server that connects Notion workspaces to MCP-compatible clients such as Claude Desktop and Cursor. It targets the Notion API 2026-03-11 and works with the current database and data source model. Responses are kept compact, with stable block IDs for editing.
Is mcp-notion-server free to use? What license does it have?
mcp-notion-server is open source under the MIT license. Check the license terms before using it in commercial products.
Is mcp-notion-server still maintained?
Updated within 6 months. The last commit to mcp-notion-server was on Jul 31, 2026.
What can I use mcp-notion-server for?
Letting an AI assistant in Claude Desktop or Cursor read and summarize Notion notes. Querying and adding entries to a Notion database from an agent workflow. Automatically appending generated Markdown content to Notion pages. Batch-updating page blocks with an AI-driven editing process.
How do I install mcp-notion-server?
Create a Notion internal integration and copy its token Add the server to your MCP host config with NOTION_API_TOKEN set: npx -y @suekou/mcp-notion-server Restart your MCP host after saving the configuration
Where can I get mcp-notion-server?
The source code and installation instructions are on GitHub: https://github.com/suekou/mcp-notion-server

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

Related projects