Каталог MCP

n24q02m/better-notion-mcp

Markdown-first MCP сервер для AI-агентов: управляет страницами, базами данных, блоками и комментариями Notion одним вызовом. Сокращает токены на 77%, поддерживает локальный и HTTP транспорт. Идеален для автоматизации Notion через ИИ.

README

11 инструментов

Версии

Установить сервер

Better Notion MCP

mcp-name: io.github.n24q02m/better-notion-mcp

Markdown-first Notion for AI agents -- pages, databases, blocks, and comments in one call.

License: MIT

Sister projects from n24q02m (click to expand)

Project	Tagline	Tag
better-code-review-graph	Knowledge graph for token-efficient code reviews -- semantic search and call-...	MCP
better-email-mcp	IMAP/SMTP email for AI agents -- read, send, organize folders, and manage att...	MCP
better-godot-mcp	Composite MCP server for Godot Engine -- 17 composite tools for AI-assisted g...	MCP
better-notion-mcp	Markdown-first Notion for AI agents -- pages, databases, blocks, and comments...	MCP
better-telegram-mcp	Telegram for AI agents -- messages, chats, media, and contacts across both bo...	MCP
claude-plugins	Claude Code plugin marketplace for the n24q02m MCP servers -- install web sea...	Marketplace
imagine-mcp	Image and video understanding + generation for AI agents -- across Gemini, Op...	MCP
jules-task-archiver	Chrome Extension for bulk operations on Jules tasks via batchexecute API -- a...	Tooling
mcp-core	Shared foundation for building MCP servers -- Streamable HTTP transport, OAut...	MCP
mnemo-mcp	Persistent AI memory with hybrid search and embedded sync. Open, free, unlimi...	MCP
qwen3-embed	Lightweight Qwen3 text embedding and reranking via ONNX Runtime and GGUF	Library
skret	Secrets without the server.	CLI
tacet	TACET: a self-distilling neuro-symbolic cascade that amortises LLM cost in kn...	Tooling
web-core	Shared web infrastructure package for search, scraping, HTTP security, and st...	Library
wet-mcp	Open-source MCP server for AI agents: web search, content extraction, and lib...	MCP

Инструменты были проиндексированы: 09.09.2026

blocks

Читает и изменяет содержимое на уровне блоков на страницах. Действия (обязательные параметры -> необязательные): - get (block_id): получает один блок - children (block_id): составляет список дочерних блоков - append (block_id, content -> position, after_block_id): добавляет содержимое Markdown на указанную позицию - update (block_id, content): заменяет содержимое текстового блока - delete (block_id): удаляет блок Используйте pages для метаданных/свойств страницы. Идентификаторы страниц допустимы как идентификаторы блоков. update работает только с текстовыми блоками (paragraph, headings, lists, quote, to_do, code). Блоки изображений и файлов содержат подписанные URL (срок действия 1 час). append поддерживает position: "start" (добавление в начало), "end" (по умолчанию), "after_block" (требует after_block_id).

Параметры

actionenumобязательный
Action to perform
after_block_idstring
Block ID to insert after (when position is after_block)
block_idstringобязательный
Block ID
contentstring
Markdown content (for append/update)
positionenum
Insert position for append: start (prepend), end (default), after_block (requires after_block_id)

comments

Управляет комментариями на странице. Действия (обязательные параметры -> необязательные): - list (page_id): все комментарии на странице - get (comment_id): один комментарий - create (content -> page_id для нового обсуждения, discussion_id для ответа)

Параметры

actionenumобязательный
Action to perform
comment_idstring
Comment ID (for get action)
contentstring
Comment content (for create)
discussion_idstring
Discussion ID (for replies)
page_idstring
Page ID

config

Управляет конфигурацией сервера и состоянием учетных данных. Действия: - status: текущее состояние учетных данных, источник токена, URL настройки - setup_status: только состояние учетных данных/настройки (псевдоним, эквивалентный status для notion; сохранен для единообразия между серверами) - setup_start (-> force): запускает настройку relay для конфигурации токена Notion через браузер - setup_reset: очищает учетные данные и конфигурацию, возвращается в состояние awaiting_setup - setup_complete: повторно проверяет учетные данные после внешних изменений конфигурации - set: обновляет параметр времени выполнения (у notion нет изменяемых параметров; возвращает информацию) - cache_clear: очищает любое кэшированное состояние (ничего не делает для notion)

Параметры

actionenumобязательный
Action to perform
forceboolean
Force setup_start even if already configured
keystring
Setting key (for set action)
valuestring
Setting value (for set action)

config__open_relayвнешний мир

Открывает форму конфигурации реле для better-notion-mcp в браузере пользователя. Возвращает URL реле, был ли запущен браузер и текущее состояние учетных данных.

Параметры

Без параметров.

content_convertтолько чтениеидемпотентный

Преобразует между Markdown и JSON блоков Notion. Команды: markdown-to-blocks (вход: строка Markdown), blocks-to-markdown (вход: JSON-массив блоков Notion или JSON-строка). Большинство инструментов (страницы, блоки) обрабатывают Markdown автоматически, используйте это только для предпросмотра/проверки. Поддерживаемый Markdown: заголовки, списки, задачи, блоки кода, цитаты, разделители, коллауты (> [!NOTE]), сворачиваемые блоки (<details>), таблицы, изображения, закладки, вставки, формулы ($$), колонки (:::columns), [toc], [breadcrumb]. Встроенный: жирный, курсив, код, зачёркнутый, ссылка.

Параметры

contentstringобязательный
Content to convert (string or array/JSON string)
directionenumобязательный
Conversion direction

databases

Схема базы данных, запросы и массовые операции со строками. Действия (обязательные параметры -> необязательные): - create (parent_id -> title, properties, is_inline, icon, cover) - get (database_id) - query (database_id -> filters, sorts, limit, search) - create_page (database_id, pages[{properties}]) - update_page (database_id, page_id, page_properties) - delete_page (database_id, page_ids) - create_data_source / update_data_source / update_database / list_templates Для CRUD одной страницы используйте pages. Принимает как database_id (из URL), так и data_source_id (из поиска в рабочем пространстве) — разрешается автоматически.

Параметры

actionenumобязательный
Action to perform
coverstring
Cover image (for update_database): URL or built-in shorthand (gradient_1..11, solid_red/yellow/blue/beige, nasa_*, met_*, rijksmuseum_*, woodcuts_*)
database_idstring
Database ID (from Notion URL) or data_source_id (from workspace search). Auto-resolved for query/create_page/list_templates.
data_source_idstring
Data source ID (for update_data_source action)
descriptionstring
Description
filtersobject
Query filters (for query action)
iconstring
Icon (for update_database): emoji (e.g. "(icon)"), external URL (https://...), or built-in shorthand (name:color, e.g. "document:gray")
is_inlineboolean
Display as inline (for create/update_database)
limitnumber
Max query results
page_idstring
Single page ID (for update_page)
page_idsstring[]
Multiple page IDs (for delete_page)
page_propertiesobject
Page properties to update (for update_page)
pagesobject[]
Array of pages for bulk create/update
parent_idstring
Parent page ID (for create/update_database)
propertiesobject
Schema properties (for create/update data source)
searchstring
Smart search across text fields (for query)
sortsobject[]
Query sorts
titlestring
Title (for database or data source)

file_uploads

Загружает файлы в Notion. Действия (обязательные параметры -> опциональные): - create (filename -> content_type, mode="single"|"multi_part", number_of_parts) - send (file_upload_id, file_content -> part_number): base64-encoded content - complete (file_upload_id) - retrieve (file_upload_id) - list (-> limit) Максимум 20 МБ напрямую, многокомпонентная загрузка для файлов большего размера.

Параметры

actionenumобязательный
Action to perform
content_typestring
MIME type (for create, e.g. "image/png")
file_contentstring
Base64-encoded file content (for send). Must be valid base64: only A-Z, a-z, 0-9, +, /, = chars. Use Buffer.from(bytes).toString("base64") to encode.
filenamestring
Filename (for create)
file_upload_idstring
File upload ID (from create step)
limitnumber
Max results for list
modeenum
Upload mode (default: single)
number_of_partsnumber
Number of parts (for multi_part mode)
part_numbernumber
Part number (for send in multi_part mode)

helpтолько чтениеидемпотентный

Получает полную документацию для инструмента. Используйте, когда сжатых описаний недостаточно.

Параметры

tool_nameenumобязательный
Tool to get documentation for

pages

CRUD для отдельных страниц и строк базы данных. Действия (обязательные параметры -> необязательные): - create (parent_id -> title, content, properties, icon, cover) - get (page_id): возвращает содержимое в формате Markdown - get_property (page_id, property_id) - update (page_id -> title, content, append_content, properties, icon, cover, archived) - move (page_id, parent_id) - archive (page_id) / restore (page_id) - duplicate (page_id -> parent_id) Используйте databases для запросов или массовых операций со строками. Формат свойств: простые значения преобразуются автоматически — строка для title/rich_text/select/status, число для number, булево для checkbox, string[] для multi_select, дата в формате ISO "2025-01-15" для date. Пример: properties: {"Name": "My Page", "Status": "In Progress", "Tags": ["tag1", "tag2"], "Due": "2025-06-01", "Count": 42, "Done": true}.

Параметры

actionenumобязательный
Action to perform
append_contentstring
Markdown to append
archivedboolean
Archive status
contentstring
Markdown content
coverstring
Cover image: URL or built-in shorthand (gradient_1..11, solid_red/yellow/blue/beige, nasa_*, met_*, rijksmuseum_*, woodcuts_*)
iconstring
Icon: emoji (e.g. "(icon)"), external URL (https://...), or built-in shorthand (name:color, e.g. "document:gray")
page_idstring
Page ID (required for most actions)
page_idsstring[]
Multiple page IDs for batch operations
parent_idstring
Parent page or database ID
propertiesobject
Page properties (for database pages). Use simple values -- auto-converted to Notion format. String: title/rich_text/select/status. Number: number. Boolean: checkbox. String[]: multi_select. ISO date string: date. Object with Notion structure: pass through as-is.
property_idstring
Property ID (for get_property action)
titlestring
Page title

usersтолько чтениеидемпотентный

Получает информацию о пользователе. Действия (обязательные параметры): - list: все пользователи рабочей области (требуются права администратора) - get (user_id): информация об одном пользователе - me: текущий пользователь бота/интеграции - from_workspace: извлекает пользователей из доступных страниц (используйте, если list не срабатывает)

Параметры

actionenumобязательный
Action to perform
user_idstring
User ID (for get action)

workspaceтолько чтениеидемпотентный

Выполняет поиск в рабочем пространстве и получает информацию о нём. Действия (обязательные параметры -> необязательные): - info: название рабочего пространства, тарифный план и бот-пользователь - search (-> query, filter.object="page"|"data_source", sort, limit): находит страницы и базы данных, предоставленные интеграции

Параметры

actionenumобязательный
Action to perform
filterobject
limitnumber
Max results
querystring
Search query
sortobject

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "--yes",
    "@n24q02m/better-notion-mcp@latest"
  ],
  "env": {
    "NOTION_TOKEN": "ntn_your_token_here"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Better Notion MCP — это сервер, который позволяет AI-агентам нормально работать с Notion: читать, создавать и обновлять страницы, базы данных, блоки и комментарии. Вместо того чтобы разбираться в JSON-респонсах Notion API и цеплять вручную пагинацию, агент получает всё в удобном Markdown и делает одной командой то, на что раньше уходило несколько запросов.

Что он умеет?

Работает с Notion через markdown. Управляет страницами и записями в базах: создаёт, читает, обновляет, удаляет. Читает схемы баз, делает запросы и массовые операции со строками. Получает и меняет блоки страниц. Ищет по воркспейсу, показывает инфу о нём и пользователях. Читает и создаёт комментарии. Конвертит markdown в блоки Notion и обратно. Загружает файлы. В конфиге показывает статус токена и открывает релей для настройки.

Информация о сервере

Номер в рейтинге: #195
Звезд на Github: 36
Форков на Github: 11
Загрузок: 22 801
Язык реализации: TypeScript
Лицензия: Apache-2.0
Официальный сервер: Нет
Дата обновления данных: 10.09 в 21:52
Идентификатор: _LnZf459LAZOyS9Z
Категории: CMS, Базы данных, Документация, Заметки, Знания и память, Рабочее место и продуктивность, Управление проектами

n24q02m/better-notion-mcp

Better Notion MCP

Похожие MCP-сервера

Notion MCP

suekou/mcp-notion-server

orellazi/coda-mcp

sooperset/mcp-atlassian

raalarcon9705/jira-mcp

UnMarkdown/mcp-server