Каталог MCP
Notion MCP

Notion MCP

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

README

24 инструмента

Версии

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

Notion MCP Server

[!NOTE]

We’ve introduced Notion MCP, a remote MCP server with the following improvements:

Easy installation via standard OAuth. No need to fiddle with JSON or API tokens anymore.

Powerful tools tailored to AI agents, including editing pages in Markdown. These tools are designed with optimized token consumption in mind.

Learn more and get started at Notion MCP documentation.

We are prioritizing, and only providing active support for, Notion MCP (remote). As a result:

We may sunset this local MCP server repository in the future.

Issues and pull requests here are not actively monitored.

Please do not file issues relating to the remote MCP here; instead, contact Notion support.

notion-mcp-sm

This project implements an MCP server for the Notion API.

mcp-demo

⚠️ Version 2.0.0 breaking changes

Version 2.0.0 migrates to the Notion API 2025-09-03 which introduces data sources as the primary abstraction for databases.

What changed

Removed tools (3):

post-database-query - replaced by query-data-source
update-a-database - replaced by update-a-data-source
create-a-database - replaced by create-a-data-source

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

API-create-a-comment

Notion | Создать комментарий Ответы с ошибками: 400: Некорректный запрос

Параметры

parentobject | stringобязательный
rich_textobject | string[]обязательный

API-create-a-data-source

Notion | Создать источник данныхОтветы с ошибками:400: Bad request

Параметры

parentany | stringобязательный
propertiesobject | stringобязательный
titleany | string | object[]

API-delete-a-block

Notion | Delete a block Ответы с ошибками: 400: Bad request

Параметры

block_idstringобязательный
Идентификатор для блока Notion

API-get-block-childrenтолько чтение

Notion | Retrieve block children Ошибки ответа: 400: Bad request

Параметры

block_idstringобязательный
Идентификатор для block
page_sizeinteger
Количество элементов из полного списка, которое требуется в ответе. Максимум: 100
start_cursorstring
Если указан, этот эндпоинт возвращает страницу результатов, начиная после предоставленного курсора. Если не указан, этот эндпоинт возвращает первую страницу результатов.

API-get-selfтолько чтение

Notion | Получить бот-пользователя вашего токена Ответы с ошибками: 400: Неверный запрос

Параметры

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

API-get-userтолько чтение

Notion | Получить данные пользователяОтветы с ошибками:400: 400

Параметры

user_idstringобязательный

API-get-usersтолько чтение

Notion | Список всех пользователей Ошибки ответа: 400: 400

Параметры

page_sizeinteger
Количество элементов из полного списка, которое требуется в ответе. Максимум: 100
start_cursorstring
Если указан, этот эндпоинт возвращает страницу результатов, начиная после предоставленного курсора. Если не указан, этот эндпоинт возвращает первую страницу результатов.

API-list-data-source-templatesтолько чтение

Notion | Список шаблонов в источнике данных Ответы с ошибками: 400: Bad request

Параметры

data_source_idstringобязательный
Идентификатор для источника данных Notion.
page_sizeinteger
start_cursorstring

API-move-page

Notion | Переместить страницу Ошибки: 400: Некорректный запрос

Параметры

page_idstringобязательный
Идентификатор страницы Notion
parentany | stringобязательный

API-patch-block-children

Notion | Добавить дочерние блоки Ответы с ошибками: 400: Bad request

Параметры

afterstring
Идентификатор существующего блока, после которого добавляется новый блок.
block_idstringобязательный
Идентификатор для block. Также принимает ID page.
childrenany | string | object[]обязательный
Дочернее содержимое для добавления в контейнерный блок в виде массива объектов блоков

API-patch-page

Notion | Обновление свойств страницы Ответы с ошибками: 400: Bad request

Параметры

archivedboolean
coverobject | string
iconobject | string
in_trashboolean
Устанавливает true для удаления блока. Устанавливает false для восстановления блока.
page_idstringобязательный
Идентификатор страницы Notion, которую необходимо обновить.
propertiesobject | string

API-post-page

Notion | Создать страницу Ответы об ошибках: 400: Bad request

Параметры

childrenstring | object[]
Контент для отображения на новой странице, представленный как массив блоков.
coverstring
Обложка новой страницы, представленная как объект файла.
iconstring
Иконка новой страницы. Либо emoji object, либо external file object..
parentany | stringобязательный
propertiesobject | stringобязательный

API-post-search

Notion | Поиск по названию Ответы с ошибками: 400: Некорректный запрос

Параметры

filterobject | string
page_sizeinteger
Количество элементов из полного списка, которые нужно включить в ответ. Максимум: 100.
querystring
Текст, с которым API сопоставляет заголовки страниц и баз данных.
sortobject | string
start_cursorstring
Значение cursor, возвращённое в предыдущем ответе. Если указано, ограничивает ответ результатами, начинающимися после cursor. Если не указано, возвращается первая страница результатов. Подробнее см. в разделе pagination.

API-query-data-source

Notion | Query a data sourceError Responses:400: Bad request

Параметры

archivedboolean
data_source_idstringобязательный
Идентификатор источника данных Notion (база данных)
filterobject | string
filter_propertiesstring | object[]
Список ID значений свойств страницы для ограничения ответа.
in_trashboolean
page_sizeinteger
sortsany | string | object[]
start_cursorstring

API-retrieve-a-blockтолько чтение

Notion | Получить блок Ошибки ответа: 400: Некорректный запрос

Параметры

block_idstringобязательный
Идентификатор для блока Notion

API-retrieve-a-commentтолько чтение

Notion | Получить комментарии Ответы об ошибках: 400: Плохой запрос

Параметры

block_idstringобязательный
Идентификатор блока или страницы Notion
page_sizeinteger
Количество элементов из полного списка, которое требуется в ответе. Максимум: 100
start_cursorstring
Если указан, этот эндпоинт возвращает страницу результатов, начиная после предоставленного курсора. Если не указан, этот эндпоинт возвращает первую страницу результатов.

API-retrieve-a-databaseтолько чтение

Notion | Retrieve a database Ответы с ошибками: 400: Неверный запрос

Параметры

database_idstringобязательный
Идентификатор базы данных Notion.

API-retrieve-a-data-sourceтолько чтение

Notion | Получить источник данныхОтветы с ошибками:400: Неверный запрос

Параметры

data_source_idstringобязательный
Идентификатор для источника данных Notion.

API-retrieve-a-pageтолько чтение

Notion | Получить страницу Ответы с ошибками: 400: Некорректный запрос

Параметры

filter_propertiesstring
Список идентификаторов значений свойств страницы, связанных со страницей. Используйте этот параметр, чтобы ограничить ответ одним или несколькими конкретными значениями свойств страницы. Чтобы получить несколько свойств, укажите каждый идентификатор свойства страницы. Например: ?filter_properties=iAk8&filter_properties=b7dh.
page_idstringобязательный
Идентификатор страницы Notion

API-retrieve-a-page-propertyтолько чтение

Notion | Получение элемента свойства страницы Ответы об ошибках: 400: Некорректный запрос

Параметры

page_idstringобязательный
Идентификатор страницы Notion
page_sizeinteger
Для свойств с постраничной выдачей. Максимальное количество объектов элементов свойств на одной странице. Размер по умолчанию: 100.
property_idstringобязательный
Идентификатор для свойства страницы
start_cursorstring
Для постраничных свойств.

API-retrieve-page-markdownтолько чтение

Notion | Извлечь страницу как Markdown Коды ошибок: 400: Неверный запрос 403: Интеграции не хватает прав на чтение/обновление контента, необходимых для этой страницы. 404: Страница не найдена или не расшарена с интеграцией. 429: Превышен лимит запросов.

Параметры

include_transcriptboolean
Нужно ли включать стенограммы заметок встречи. Когда задано false (по умолчанию), вместо полной стенограммы отображается заглушка с URL заметки встречи.
page_idstringобязательный
Идентификатор страницы (или блока) Notion для чтения или обновления в формате Markdown.

API-update-a-block

Notion | Обновить блок Ошибки: 400: Неверный запрос

Параметры

archivedboolean
Установите true, чтобы архивировать (удалить) блок. Установите false, чтобы разархивировать (восстановить) блок.
block_idstringобязательный
Идентификатор для блока Notion
typeobject | string

API-update-a-data-source

Notion | Обновление источника данныхОтветы с ошибками:400: Bad request

Параметры

data_source_idstringобязательный
Идентификатор для источника данных Notion.
descriptionany | string | object[]
propertiesobject | string
titleany | string | object[]

API-update-page-markdown

Notion | Обновить содержимое страницы в формате Markdown Ответы с ошибками: 400: Неверный запрос 403: У интеграции нет прав на чтение или обновление контента для этой страницы. 404: Страница не найдена или не предоставлена интеграции. 409: Конфликт (например, превышен лимит строк). 429: Превышен лимит запросов.

Параметры

insert_contentobject | string
page_idstringобязательный
Идентификатор страницы (или блока) Notion для чтения или обновления в формате Markdown.
replace_contentobject | string
replace_content_rangeobject | string
typeenumобязательный
Тип применяемого редактирования. Предпочтительнее использовать replace_content (перезапись всей страницы) или update_content (целевой поиск и замена). insert_content и replace_content_range устарели.
update_contentobject | string

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

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

{
  "command": "npx",
  "args": [
    "-y",
    "@notionhq/notion-mcp-server"
  ],
  "env": {
    "NOTION_TOKEN": "ntn_****"
  }
}

Нужен npx

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

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

FAQ

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

Этот сервер соединяет AI-агентов с Notion, чтобы те могли читать и редактировать страницы в Markdown, управлять базами данных и выполнять поиск. Вместо ручной работы через интерфейс или сложных API-запросов — разработчик даёт указания на естественном языке, а сервер сам обращается к Notion. Главное — ускорить автоматизацию заметок, документации и проектов, экономя токены и время.

Что он умеет?

Читает страницы Notion целиком в Markdown, обновляет их содержимое точечно или полностью. Управляет блоками: читает блоки и их детей, добавляет, обновляет, удаляет их. Создаёт и обновляет данные-источники, запрашивает их с фильтрами и сортировкой, читает схему и метаданные, перечисляет шаблоны. Создаёт страницы и комментарии, читает и обновляет свойства страниц, перемещает страницы, ищет по названию, получает пользователей и текущего бота.

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

Номер в рейтинге: #34
Звезд на Github: 4625
Форков на Github: 624
Загрузок: 2 829 854
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Да
Дата обновления данных: 10.09 в 21:53
Идентификатор: RncO4E_I3uEMnUlp
Категории: CMS, Автоматизация приложений, Базы данных, Документация, Заметки, Знания и память, Инструменты для разработчиков, Коммуникации, Поиск, Рабочее место и продуктивность, Управление проектами