{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_aju3hppzkz39","handle":"notion-mcp-2","url":"https://wellknown.network/agents/notion-mcp-2","links":{"self":"https://wellknown.network/agents/notion-mcp-2/record.json","html":"https://wellknown.network/agents/notion-mcp-2","markdown":"https://wellknown.network/agents/notion-mcp-2/record.md","api":"https://wellknown.network/api/v1/agents/notion-mcp-2","status":"https://wellknown.network/api/v1/agents/notion-mcp-2/status","claim":"https://wellknown.network/agents/notion-mcp-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/notion-mcp-2/claim.json","badge":"https://wellknown.network/agents/notion-mcp-2/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/notion-mcp-2/history","tools":"https://wellknown.network/api/v1/agents/notion-mcp-2/tools"},"ard":{"identifier":"urn:air::server:notion-mcp-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"notion-mcp","summary":"MCP server for Notion: pages, databases, markdown, comments, and a full file pipeline","description":"# notion-mcp\n\nAn [MCP](https://modelcontextprotocol.io) server for the Notion API:\npages, databases (2025-09+ data-source model handled transparently),\nnative markdown read/write, comments, users, and a **full file\npipeline** — upload/replace/import/download with positional inserts,\npage icons/covers, multi-part upload for large files, and in-place PDF\nreading with optional OCR. Built on the\n[Python MCP SDK](https://github.com/modelcontextprotocol/python-sdk)\n(FastMCP); runs as a local stdio server or a containerized Streamable\nHTTP service with bearer auth. 55 tools.\n\n> Unofficial project, not affiliated with or endorsed by Notion.\n\n## Table of Contents\n\n- [Quick Start](#quick-start)\n- [Tool Reference](#tool-reference)\n  - [Search & Discovery](#search--discovery)\n  - [Reading Pages](#reading-pages)\n  - [Creating & Writing Pages](#creating--writing-pages)\n  - [Editing Page Content](#editing-page-content)\n  - [Page Lifecycle](#page-lifecycle)\n  - [Block Operations](#block-operations)\n  - [Database Schema](#database-schema)\n  - [Database Queries](#database-queries)\n  - [Database Rows & Files](#database-rows--files)\n  - [File Downloads](#file-downloads)\n  - [PDF Reading & OCR](#pdf-reading--ocr)\n  - [Comments](#comments)\n  - [Views](#views)\n  - [Users](#users)\n  - [Meeting Notes](#meeting-notes)\n  - [Custom Emojis & Upload Listing](#custom-emojis--upload-listing)\n- [Markdown Format](#markdown-format)\n- [Working with Databases](#working-with-databases)\n- [Working with Files](#working-with-files)\n- [Common Workflows](#common-workflows)\n- [Configuration](#configuration)\n- [Architecture](#architecture)\n- [Development](#development)\n- [Testing](#testing)\n- [Local stdio Mode](#local-stdio-mode)\n- [Container Deployment](#container-deployment)\n- [MCP Client Registration](#mcp-client-registration)\n- [Notion API Version Notes](#notion-api-version-notes)\n\n## Quick Start\n\n```bash\n# Prerequisites: Python 3.12+, uv\nuv sync\n\n# Set your Notion integration token\nexport NOTION_TOKEN=nt…","publisher":null,"homepage":"https://github.com/snickery/notion-mcp","repository":"https://github.com/snickery/notion-mcp","version":"0.2.2","license":null,"protocols":["mcp"],"tags":["files","markdown","mcp","model-context-protocol","notion"],"pricing":null,"endpoints":[{"url":"pypi:notion-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"productivity.notes","name":"Notes & Docs","confidence":1,"provenance":"declared"},{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"declared"},{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":0.848,"provenance":"derived"},{"slug":"content.writing","name":"Writing & Editing","confidence":0.802,"provenance":"derived"}],"categories":["content","dev","productivity"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"notion-mcp","registry":"pypi","observedAt":"2026-11-03T20:29:31.332Z","publishedAt":"2026-10-25T11:45:31.368134Z","latestVersion":"0.2.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"notion-mcp","url":"https://pypi.org/project/notion-mcp/","firstSeenAt":"2026-09-10T08:25:33.720Z","fetchedAt":"2026-11-03T20:27:47.358Z","normalizedAt":"2026-11-03T20:27:47.358Z"}]},"firstSeenAt":"2026-09-10T08:25:33.720Z","updatedAt":"2026-11-03T20:29:31.332Z"}