MCP server for Notion: pages, databases, markdown, comments, and a full file pipeline
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"notion-mcp-2","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# notion-mcp An [MCP](https://modelcontextprotocol.io) server for the Notion API: pages, databases (2025-09+ data-source model handled transparently), native markdown read/write, comments, users, and a **full file pipeline** — upload/replace/import/download with positional inserts, page icons/covers, multi-part upload for large files, and in-place PDF reading with optional OCR. Built on the [Python MCP SDK](https://github.com/modelcontextprotocol/python-sdk) (FastMCP); runs as a local stdio server or a containerized Streamable HTTP service with bearer auth. 55 tools. > Unofficial project, not affiliated with or endorsed by Notion. ## Table of Contents - [Quick Start](#quick-start) - [Tool Reference](#tool-reference) - [Search & Discovery](#search--discovery) - [Reading Pages](#reading-pages) - [Creating & Writing Pages](#creating--writing-pages) - [Editing Page Content](#editing-page-content) - [Page Lifecycle](#page-lifecycle) - [Block Operations](#block-operations) - [Database Schema](#database-schema) - [Database Queries](#database-queries) - [Database Rows & Files](#database-rows--files) - [File Downloads](#file-downloads) - [PDF Reading & OCR](#pdf-reading--ocr) - [Comments](#comments) - [Views](#views) - [Users](#users) - [Meeting Notes](#meeting-notes) - [Custom Emojis & Upload Listing](#custom-emojis--upload-listing) - [Markdown Format](#markdown-format) - [Working with Databases](#working-with-databases) - [Working with Files](#working-with-files) - [Common Workflows](#common-workflows) - [Configuration](#configuration) - [Architecture](#architecture) - [Development](#development) - [Testing](#testing) - [Local stdio Mode](#local-stdio-mode) - [Container Deployment](#container-deployment) - [MCP Client Registration](#mcp-client-registration) - [Notion API Version Notes](#notion-api-version-notes) ## Quick Start ```bash # Prerequisites: Python 3.12+, uv uv sync # Set your Notion integration token export NOTION_TOKEN=nt…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.