Notion MCP Server by suekou
A Model Context Protocol server for connecting Notion to MCP-compatible clients
About Notion MCP Server
From the project's README at github.com/suekou/mcp-notion-server. Lightly cleaned for readability; for the full source see the upstream repo.
AI-friendly MCP server for the Notion API. It helps agents find, read, query, and update Notion workspaces while keeping responses compact enough for day-to-day AI workflows.
This server targets the Notion API and uses the current database/data source model. It exposes MCP tools, prompts, resources, structured tool results, and optional MCP Apps for interactive Notion workflows. Highlights Search and target discovery with . Compact page reading with stable block IDs via . Data source schema inspection with . Schema-aware data source querying and item creation with simple values. Simple page editing tools for paragraphs, headings, lists, todos, quotes, callouts, code blocks, dividers, and safe Markdown append. Raw Notion API tools for advanced block, page, database, data source, comment, and user operations. Optional MCP Apps: Data Source Explorer and Page Workbench. Quick Start
Restart your MCP host after saving the configuration. Setup Guide 1. Create a Notion integration
Open the Notion integrations dashboard, then create a new internal int
Health score breakdown
6-dimension composite. See methodology for formula and weights.
Adoption signals
Real-world usage data, pulled from each registry. The bigger the numbers, the more battle-tested the project.
| Signal | Value | Source |
|---|---|---|
| GitHub stars | 884 | github.com/suekou/mcp-notion-server |
| GitHub forks | 171 | github.com/suekou/mcp-notion-server |
| NPM downloads (last month) | 5.0k | @suekou/mcp-notion-server |
Release & maintenance
Is this project actively maintained, or about to die? Check the recency of last commit and last release.
| Project age | 1.4 years | since Nov 2024 |
| Last commit | 2 days ago | May 5, 2026 |
| Releases shipped | 11 | last: 2 days ago |
Self-hosting cost across providers
Detected requirements: 4GB RAM, 40GB disk minimum. Cheapest plan per provider that meets the requirement.
| Provider | Plan | Specs | Monthly | |
|---|---|---|---|---|
| hetzner | CAX11 | 2c · 4GB · 40GB | $4.13 USD | Deploy → |
| vultr | VC2 | 1c · 1GB · 25GB | $5 USD | Deploy → |
| linode | Nanode 1GB | 1c · 1GB · 25GB | $5.12 USD | Deploy → |
| digitalocean | Basic Regular 1GB | 1c · 1GB · 25GB | $6 USD | Deploy → |
Replaces these paid SaaS
Notion MCP Server is one of the open-source alternatives to:
Ready to self-host Notion MCP Server?
Spin up a hetzner CAX11 (4GB RAM, 40GB disk) for $4.13/mo and follow the project's official install docs.
Data last refreshed May 7, 2026.
Similar open-source projects
Projects in our directory that replace the same SaaS or share topics with Notion MCP Server.