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

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

Что он умеет?

Сервер находит страницы и data source по названию, читает страницы и блоки в компактном виде, создаёт базы данных и добавляет data source к существующим. Он инспектирует схему data source, запрашивает элементы с фильтрами и сортировкой, создаёт элементы по простым значениям, обновляет свойства страниц и data source. Для редактирования добавляет Markdown, создаёт блоки, обновляет их по отдельности и пачками, удаляет лишние. Ещё читает и создаёт комментарии, получает пользователей и открывает интерактивные MCP-приложения для работы с data source и страницами.

Каталог MCP

suekou/mcp-notion-server

от suekou

MCP-сервер для интеграции Notion с AI-агентами: поиск, чтение, редактирование страниц и баз данных, создание элементов, выполнение запросов. Компактные ответы для AI-рабочих процессов. Для разработ...

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

README

31 инструмент

Версии

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

Notion MCP Server

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 2026-03-11 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 notion_find.
Compact page reading with stable block IDs via notion_read_page.
Data source schema inspection with notion_inspect_data_source.
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

Add this server to an MCP host such as Claude Desktop:

Часто задаваемые вопросы

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

notion_append_block_children

Добавляет новые дочерние блоки к указанному родительскому блоку в Notion. Требует возможности вставки содержимого. Используйте необязательный объект 'position' для вставки в начало, конец или после конкретного блока.

Добавляет дочерние блоки.

Параметры

block_idstringобязательный
Идентификатор родительского блока. Он должен представлять собой строку из 32 символов (без учёта дефисов), отформатированную как 8-4-4-4-12 с дефисами (-).
childrenobject[]обязательный
Массив объектов блоков для добавления. Каждый блок должен соответствовать схеме блоков Notion.
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
positionobject
Куда вставить дочерние блоки. Если опустить это, они добавятся в конец. Используйте { type: 'after_block', after_block: { id } } вместо старого параметра 'after' из Notion API.

notion_append_content

Добавляет обычное содержимое Notion без написания сырого JSON блоков Notion. Используйте это для повседневного редактирования страниц, когда пользователь хочет добавить абзацы, заголовки, списки, задачи, цитаты, выделенные блоки, блоки кода или разделители. Для неподдерживаемых типов блоков или расширенного форматирования текста используйте notion_append_block_children с сырыми объектами блоков Notion.

Добавляет простое содержимое.

Параметры

block_idstringобязательный
Родительский блок или идентификатор страницы, к которому нужно добавить содержимое. Это должна быть строка из 32 символов (без учёта дефисов), отформатированная как 8-4-4-4-12 с дефисами (-).
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
itemsobject[]обязательный
Упрощённые элементы контента для добавления по порядку. Оставляйте партии достаточно небольшими, чтобы было легче проверять.
positionobject
Куда вставить содержимое. Опустите это, чтобы добавить в конец.

notion_append_markdown

Добавляет безопасное подмножество Markdown на страницу или блок Notion без написания сырого JSON блоков Notion. Поддерживает заголовки (#, ##, ###), абзацы, маркированные списки, нумерованные списки, задачи (- [ ] / - [x]), цитаты, разделители и блоки кода с обрамлением. Используйте этот инструмент, когда пользователь предоставляет Markdown-подобный контент и хочет его добавить; для таблиц, изображений, аннотаций форматированного текста, вложенных списков или продвинутых блоков Notion используйте инструменты для сырых блоков.

Добавляет содержимое Markdown

Параметры

block_idstringобязательный
Идентификатор родительского блока или страницы, к которому нужно добавить содержимое Markdown. Это должна быть строка из 32 символов (без учёта дефисов), отформатированная как 8-4-4-4-12 с дефисами (-).
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
markdownstringобязательный
Содержимое Markdown для преобразования в простые блоки Notion. Неподдерживаемый Markdown обрабатывается как обычный текст абзаца, где это возможно.
positionobject
Куда вставить содержимое. Опустите это, чтобы добавить в конец.

notion_create_comment

Создаёт комментарий в Notion. Для этого интеграция должна иметь возможность 'insert comment'. Вы можете указать либо родительскую страницу, либо discussion_id, но не оба одновременно.

Создаёт комментарий

Параметры

discussion_idstring
Идентификатор существующей ветки обсуждения, к которой нужно добавить комментарий. Он должен представлять собой строку из 32 символов (без учёта дефисов), отформатированную по шаблону 8-4-4-4-12 с дефисами (-).
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
parentobject
Родительский объект, указывающий страницу, на которой оставляется комментарий. При использовании должен содержать page_id.
rich_textobject[]обязательный
Массив объектов форматированного текста, представляющих содержимое комментария.

notion_create_database

Создаёт базу данных Notion и её исходный источник данных. Для Notion API 2025-09-03+ помещает начальную схему под initial_data_source.properties.

Создает базу данных

Параметры

coverobject
Необязательный объект обложки Notion для базы данных.
descriptionobject[]
Описание базы данных в виде массива объектов форматированного текста.
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
iconobject
Необязательный объект иконки Notion для базы данных.
initial_data_sourceobjectобязательный
Начальная конфигурация источника данных. Укажите свойства здесь, а не как свойство базы данных верхнего уровня.
is_inlineboolean
Отображать ли базу данных встроенно на родительской странице. По умолчанию false.
parentobjectобязательный
Родительская страница или объект рабочего пространства для новой базы данных, например { type: 'page_id', page_id: '...' }.
titleobject[]
Название базы данных в виде массива объектов форматированного текста.

notion_create_data_source

Добавляет дополнительный источник данных Notion к существующей базе данных. Не используйте это для создания новой базы данных, используйте notion_create_database для этого.

Создаёт источник данных

Параметры

formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
parentobjectобязательный
Существующий родительский объект базы данных, например { type: 'database_id', database_id: '...' }.
propertiesobjectобязательный
Схема свойств источника данных. Ключи — это имена свойств, а значения — объекты схемы свойств.
titleobject[]
Название источника данных, как оно отображается в Notion. Массив объектов форматированного текста.

notion_create_data_source_item

Создаёт новый элемент страницы в источнике данных Notion. Используйте data_source_id, а не database_id, в качестве родителя.

Создаёт элемент источника данных

Параметры

data_source_idstringобязательный
ID источника данных, в который нужно добавить элемент. Он должен быть строкой из 32 символов (без учёта дефисов), в формате 8-4-4-4-12 с дефисами (-).
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
propertiesobjectобязательный
Свойства нового элемента базы данных. Они должны соответствовать схеме базы данных.

notion_create_data_source_item_from_values

Создаёт новый элемент страницы в источнике данных Notion, используя простые значения свойств вместо необработанного JSON-свойства Notion. Сервер получает схему источника данных и преобразует распространённые типы свойств за вас: title, rich_text, number, checkbox, select, status, multi_select, date, url, email, phone_number, relation и people. Сначала используйте notion_inspect_data_source, когда вам нужны правильные имена свойств или значения опций.

Создаёт элемент из значений

Параметры

data_source_idstringобязательный
ID источника данных, в который нужно добавить элемент. Он должен быть строкой из 32 символов (без учёта дефисов), в формате 8-4-4-4-12 с дефисами (-).
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
valuesobjectобязательный
Простые значения свойств, ключом которых является точное имя свойства Notion. Примеры: { Name: 'Task', Status: 'Done', Tags: ['AI', 'MCP'], Due: '2026-05-04', Done: false }.

notion_delete_blockидемпотентный

Удаляет блок в Notion

Удаляет блок.

Параметры

block_idstringобязательный
Идентификатор блока для удаления. Он должен быть строкой из 32 символов (без учёта дефисов), отформатированной как 8-4-4-4-12 с дефисами (-).
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.

notion_findтолько чтение

Находит страницы Notion или источники данных и возвращает компактные, подходящие для ИИ кандидаты со стабильными ID и предлагает следующие инструменты. Используйте этот инструмент перед низкоуровневыми инструментами retrieve/query, когда пользователь указывает название, частичное имя или расплывчатую цель. Предпочитайте его прямому notion_search для поиска, потому что он отсекает шумные поля API и выделяет ID, необходимые для следующего действия.

Находит цели Notion

Параметры

formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
object_typeenum
Необязательный фильтр по типу цели. Используйте 'page' при поиске страниц с контентом и 'data_source' при поиске схем, похожих на базы данных, для запросов или создания элементов в них.
page_sizenumber
Сколько кандидатов возвращать. Держите это число небольшим, чтобы не раздувать контекст ИИ; максимум 100.
querystring
Ищет текст в заголовках страниц Notion или источников данных. Если не указано, показывает список доступных объектов.
start_cursorstring
Начальный курсор пагинации из предыдущего вызова notion_find.

notion_inspect_data_sourceтолько чтение

Проверяет схему источника данных Notion и возвращает компактную сводку свойств для AI-агентов. Используйте это перед созданием или обновлением элементов, чтобы модель могла выбирать допустимые имена свойств, значения опций и цели связей без чтения полного объекта API Notion.

Проверяет источник данных

Параметры

data_source_idstringобязательный
Идентификатор источника данных для проверки. Если у вас есть только название или идентификатор базы данных, сначала используйте notion_find или notion_retrieve_database. Это должна быть строка из 32 символов (без дефисов), отформатированная как 8-4-4-4-12 с дефисами (-).
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.

notion_list_all_usersтолько чтение

Выводит список всех пользователей в рабочем пространстве Notion. Примечание: Для использования этой функции требуется обновить тарифный план до Notion Enterprise и использовать ключ API организации, чтобы избежать ошибок разрешений.

Перечисляет пользователей.

Параметры

formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
page_sizenumber
Количество пользователей для получения (максимум 100)
response_modeenum
Управляет размером ответа для инструментов, работающих со списками. По умолчанию используется режим auto, чтобы сервер возвращал компактные сводки, когда ответ Notion получается слишком громоздким. Режим compact подходит, когда достаточно идентификаторов и сводок. Режим full используйте только тогда, когда для продвинутой операции нужны сырые объекты API Notion.
start_cursorstring
Стартовый курсор пагинации для вывода списка пользователей.

notion_open_data_source_app

Открывает интерактивное приложение Notion Data Source Explorer MCP App для инспекции схемы, создания фильтров, выполнения запросов и создания элементов из простых значений.

Open Data Source Explorer

Параметры

data_source_idstring
Необязательный ID исходного источника данных для проверки и запроса. Это строка из 32 символов (без учёта дефисов) в формате 8-4-4-4-12 с дефисами (-).
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.

notion_open_page_workbench

Открывает интерактивное приложение Notion Page Workbench MCP для чтения содержимого страницы, выбора ID блоков, обновления простых блоков и добавления Markdown.

Open Page Workbench

Параметры

formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
page_idstring
Необязательный начальный ID страницы для чтения. Он должен быть строкой из 32 символов (без учёта дефисов), отформатированной как 8-4-4-4-12 с дефисами (-).

notion_query_data_sourceтолько чтение

Запрашивает источник данных Notion с фильтрацией, сортировкой и пагинацией. Сначала используйте notion_retrieve_database, если у вас есть только ID базы данных и нужно узнать её data_source_id.

Query Data Source

Параметры

data_source_idstringобязательный
Идентификатор источника данных для запроса. Он должен представлять собой строку из 32 символов (без учёта дефисов), отформатированную как 8-4-4-4-12 с дефисами (-).
filterobject
Условия фильтрации
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
page_sizenumber
Количество результатов на странице (максимум 100)
response_modeenum
Управляет размером ответа для инструментов, работающих со списками. По умолчанию используется режим auto, чтобы сервер возвращал компактные сводки, когда ответ Notion получается слишком громоздким. Режим compact подходит, когда достаточно идентификаторов и сводок. Режим full используйте только тогда, когда для продвинутой операции нужны сырые объекты API Notion.
sortsobject[]
Сортировать условия
start_cursorstring
Курсор пагинации для следующей страницы результатов

notion_query_data_source_by_valuesтолько чтение

Запрашивает источник данных Notion, используя простые фильтры и сортировки, учитывающие схему, вместо необработанного JSON-фильтра Notion. Используйте это после notion_inspect_data_source, когда пользователь запрашивает типовые запросы, такие как Status equals Done, Tags contains AI, Due on or before a date, Estimate greater than 3 или Done equals false. Сервер проверяет имена свойств, имена опций, типы значений и поддерживаемые операторы перед вызовом Notion.

Запрашивает источник данных по значениям

Параметры

data_source_idstringобязательный
Идентификатор источника данных для запроса. Он должен представлять собой строку из 32 символов (без учёта дефисов), отформатированную как 8-4-4-4-12 с дефисами (-).
filtersobject[]
Простые фильтры с учётом схемы. По умолчанию несколько фильтров объединяются с match=all.
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
matchenum
Как объединить несколько фильтров. all соответствует and в Notion; any соответствует or в Notion.
page_sizenumber
Количество результатов на странице (максимум 100)
response_modeenum
Управляет размером ответа для инструментов, работающих со списками. По умолчанию используется режим auto, чтобы сервер возвращал компактные сводки, когда ответ Notion получается слишком громоздким. Режим compact подходит, когда достаточно идентификаторов и сводок. Режим full используйте только тогда, когда для продвинутой операции нужны сырые объекты API Notion.
sortsobject[]
Простые типы свойств.
start_cursorstring
Курсор пагинации для следующей страницы результатов

notion_read_pageтолько чтение

Читает страницу Notion с компактными метаданными страницы и содержимым блоков в формате, удобном для ИИ: outline или Markdown. Используйте этот инструмент после notion_find, когда нужно понять или отредактировать страницу. Он получает дочерние блоки с ограничениями max_depth и max_blocks, чтобы большие страницы не перегружали модель. Outline включает стабильные идентификаторы блоков, которые можно использовать с notion_append_content position.after_block.

Читает содержимое страницы.

Параметры

content_formatenum
Как представлять содержимое страницы. Используйте outline для компактных идентификаторов блоков и текста, markdown — для удобочитаемого просмотра, или json — для структурированного описания без отрисованной разметки Markdown.
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
include_propertiesboolean
Включать ли компактные значения свойств страницы в ответ. По умолчанию false, чтобы экономить контекст.
max_blocksnumber
Максимальное количество блоков для получения по всему дереву страниц. По умолчанию 100.
max_depthnumber
Максимальная глубина вложенных блоков для загрузки. По умолчанию — 2. Увеличивайте только при необходимости получить вложенный контент.
page_idstringобязательный
Идентификатор страницы для чтения. Это должна быть 32-символьная строка (без учёта дефисов) в формате 8-4-4-4-12 с дефисами (-).
page_sizenumber
Количество дочерних блоков, запрашиваемых на страницу Notion API. По умолчанию равно 100 и не может превышать 100.

notion_retrieve_blockтолько чтение

Получает блок из Notion.

Получает блок

Параметры

block_idstringобязательный
ID блока для получения. Это должна быть строка из 32 символов (без учёта дефисов), отформатированная как 8-4-4-4-12 с дефисами (-).
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.

notion_retrieve_block_childrenтолько чтение

Извлекает дочерние элементы блока.

Получает дочерние элементы блока

Параметры

block_idstringобязательный
Идентификатор блока. Это должна быть строка из 32 символов (без учёта дефисов), отформатированная как 8-4-4-4-12 с дефисами (-).
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
page_sizenumber
Количество результатов на странице (максимум 100)
response_modeenum
Управляет размером ответа для инструментов, работающих со списками. По умолчанию используется режим auto, чтобы сервер возвращал компактные сводки, когда ответ Notion получается слишком громоздким. Режим compact подходит, когда достаточно идентификаторов и сводок. Режим full используйте только тогда, когда для продвинутой операции нужны сырые объекты API Notion.
start_cursorstring
Курсор пагинации для следующей страницы результатов

notion_retrieve_bot_userтолько чтение

Получает пользователя-бота, связанного с текущим токеном в Notion.

Получает пользователя-бота

Параметры

formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.

notion_retrieve_commentsтолько чтение

Извлекает список неразрешённых комментариев из страницы или блока Notion. Интеграция должна обладать возможностью 'read comment'.

Извлекает комментарии

Параметры

block_idstringобязательный
Идентификатор блока или страницы, комментарии к которым вы хотите получить. Он должен представлять собой строку из 32 символов (без учёта дефисов), отформатированную как 8-4-4-4-12 с дефисами (-).
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
page_sizenumber
Количество комментариев для получения (максимум 100).
response_modeenum
Управляет размером ответа для инструментов, работающих со списками. По умолчанию используется режим auto, чтобы сервер возвращал компактные сводки, когда ответ Notion получается слишком громоздким. Режим compact подходит, когда достаточно идентификаторов и сводок. Режим full используйте только тогда, когда для продвинутой операции нужны сырые объекты API Notion.
start_cursorstring
Если указан, возвращает страницу результатов, начиная с позиции после курсора.

notion_retrieve_databaseтолько чтение

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

Получает базу данных

Параметры

database_idstringобязательный
Идентификатор базы данных для получения. Он должен быть строкой из 32 символов (без учёта дефисов), отформатированной как 8-4-4-4-12 с дефисами (-).
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.

notion_retrieve_data_sourceтолько чтение

Получает метаданные и схему свойств для источника данных Notion.

Получает источник данных

Параметры

data_source_idstringобязательный
Идентификатор источника данных для получения. Он должен быть строкой из 32 символов (без учёта дефисов) в формате 8-4-4-4-12 с дефисами (-).
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.

notion_retrieve_pageтолько чтение

Получает страницу из Notion

Извлекает страницу.

Параметры

formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
page_idstringобязательный
Идентификатор страницы для получения. Он должен представлять собой строку из 32 символов (без учёта дефисов), отформатированную как 8-4-4-4-12 с дефисами (-).

notion_retrieve_userтолько чтение

Получает конкретного пользователя по user_id в Notion. Примечание: Эта функция требует обновления до тарифного плана Notion Enterprise и использования Organization API key, чтобы избежать ошибок разрешений.

Получает пользователя.

Параметры

formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
user_idstringобязательный
Идентификатор пользователя для получения. Он должен быть строкой из 32 символов (без учёта дефисов), отформатированной как 8-4-4-4-12 с дефисами (-).

notion_searchтолько чтение

Ищет страницы или источники данных по названию в Notion

Ищет в Notion

Параметры

filterobject
Фильтровать результаты по типу объекта (страница или data_source)
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
page_sizenumber
Количество возвращаемых результатов (максимум 100).
querystring
Текст для поиска в заголовках страниц или источников данных
response_modeenum
Управляет размером ответа для инструментов, работающих со списками. По умолчанию используется режим auto, чтобы сервер возвращал компактные сводки, когда ответ Notion получается слишком громоздким. Режим compact подходит, когда достаточно идентификаторов и сводок. Режим full используйте только тогда, когда для продвинутой операции нужны сырые объекты API Notion.
sortobject
Порядок сортировки результатов
start_cursorstring
Курсор начала пагинации

notion_update_blockидемпотентный

Обновляет содержимое блока в Notion на основе его типа. Обновление заменяет всё значение для указанного поля.

Обновляет блок

Параметры

blockobjectобязательный
Обновленное содержимое для блока. Должно соответствовать схеме типа блока.
block_idstringобязательный
Идентификатор блока для обновления. Это строка из 32 символов (без учёта дефисов), отформатированная как 8-4-4-4-12 с дефисами (-).
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.

notion_update_contentидемпотентный

Обновляет существующий блок Notion без написания raw JSON блока Notion. Используйте этот инструмент после того, как notion_read_page выдаст вам ID блока, и вам нужно заменить текст или простые поля существующего paragraph, heading, list item, todo, quote, callout или code block. item.type должен соответствовать текущему типу блока; этот инструмент отклонит несоответствия, чтобы модель могла исправить себя.

Обновляет простое содержимое

Параметры

block_idstringобязательный
Существующий ID блока для обновления. Используйте notion_read_page, чтобы найти ID блока. Он должен быть строкой из 32 символов (без дефисов), отформатированной как 8-4-4-4-12 с дефисами (-).
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
itemobjectобязательный
Упрощённый элемент содержимого Notion для обновления существующего редактируемого блока. Тип должен совпадать с текущим типом блока.

notion_update_content_batchидемпотентный

Обновляет несколько существующих блоков Notion без написания сырого JSON блоков Notion. Используйте этот инструмент после notion_read_page, когда пользователь хочет внести несколько простых текстовых изменений одновременно. Сервер извлекает каждый целевой блок и проверяет все значения item.type перед применением обновлений, поэтому ошибки в типе блока приводят к сбою до того, как будет предпринята попытка записи.

Update Simple Content Batch

Параметры

formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
updatesobject[]обязательный
Партия существующих блоков для обновления. Сохраняйте партии проверяемыми и используйте ID блоков из notion_read_page.

notion_update_data_sourceидемпотентный

Обновляет заголовок, описание или свойства источника данных Notion.

Обновляет источник данных

Параметры

data_source_idstringобязательный
Идентификатор источника данных для обновления. Он должен быть строкой из 32 символов (без учёта дефисов), отформатированной как 8-4-4-4-12 с дефисами (-).
descriptionobject[]
Массив объектов форматированного текста, который представляет описание базы данных, отображаемое в интерфейсе Notion.
formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
propertiesobject
Свойства базы данных, которые нужно изменить в запросе, в виде JSON-объекта.
titleobject[]
Массив объектов форматированного текста, представляющий заголовок базы данных, отображаемый в интерфейсе Notion.

notion_update_page_propertiesидемпотентный

Обновляет свойства страницы или элемента в базе данных Notion.

Обновляет свойства страницы.

Параметры

formatenum
Укажите формат ответа. «json» возвращает исходную структуру данных, «markdown» — более читаемый формат. Используйте «markdown», когда пользователю нужно просто прочитать страницу, и он не планирует записывать или изменять её. Используйте «json», когда пользователю нужно прочитать страницу с целью записи в неё или её изменения.
page_idstringобязательный
Идентификатор страницы или элемента базы данных для обновления. Он должен быть строкой из 32 символов (без учёта дефисов), отформатированной как 8-4-4-4-12 с дефисами (-).
propertiesobjectобязательный
Свойства для обновления. Они соответствуют столбцам или полям в базе данных.

`2.0.2`основная	22.06.2026
`2.0.1`	22.06.2026
`2.0.0`	05.05.2026
`1.2.4`	14.05.2025
`1.2.3`	11.04.2025
`1.2.2`	07.04.2025
`1.2.1`	06.04.2025
`1.2.0`	06.04.2025
`1.1.1`	31.03.2025
`1.1.0`	25.03.2025
`1.0.2`	10.03.2025
`1.0.1`	07.03.2025
`1.0.0`	14.12.2024

Выберите клиент, чтобы установить suekou/mcp-notion-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "suekou-mcp-notion-server-0b3otb2mzp": {
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      },
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "command": "npx"
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "suekou-mcp-notion-server-0b3otb2mzp": {
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      },
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "command": "npx"
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "suekou-mcp-notion-server-0b3otb2mzp": {
      "type": "stdio",
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      },
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "command": "npx"
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"suekou-mcp-notion-server-0b3otb2mzp\",\"type\":\"stdio\",\"env\":{\"NOTION_API_TOKEN\":\"your-integration-token\"},\"args\":[\"-y\",\"@suekou/mcp-notion-server\"],\"command\":\"npx\"}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "suekou-mcp-notion-server-0b3otb2mzp": {
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      },
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "command": "npx"
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add suekou-mcp-notion-server-0b3otb2mzp --env NOTION_API_TOKEN=your-integration-token -- npx -y @suekou/mcp-notion-server

Либо через JSON-конфиг:

claude mcp add-json suekou-mcp-notion-server-0b3otb2mzp "{\"env\":{\"NOTION_API_TOKEN\":\"your-integration-token\"},\"args\":[\"-y\",\"@suekou/mcp-notion-server\"],\"command\":\"npx\"}"

Codex

Добавьте сервер командой в терминале:

codex mcp add suekou-mcp-notion-server-0b3otb2mzp --env NOTION_API_TOKEN=your-integration-token -- npx -y @suekou/mcp-notion-server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.suekou-mcp-notion-server-0b3otb2mzp]
command = "npx"
args = ["-y", "@suekou/mcp-notion-server"]

[mcp_servers.suekou-mcp-notion-server-0b3otb2mzp.env]
NOTION_API_TOKEN = "your-integration-token"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите suekou/mcp-notion-server, а в поле команды запуска — строку ниже:

npx -y @suekou/mcp-notion-server

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "suekou-mcp-notion-server-0b3otb2mzp": {
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      },
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "command": "npx"
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "suekou-mcp-notion-server-0b3otb2mzp": {
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      },
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "command": "npx",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например suekou-mcp-notion-server-0b3otb2mzp.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: suekou-mcp-notion-server-0b3otb2mzp
    command: npx
    args:
      - "-y"
      - "@suekou/mcp-notion-server"
    env:
      NOTION_API_TOKEN: your-integration-token

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "suekou-mcp-notion-server-0b3otb2mzp": {
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      },
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "command": "npx"
    }
  }
}

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

{
  "command": "npx",
  "args": [
    "-y",
    "@suekou/mcp-notion-server"
  ],
  "env": {
    "NOTION_API_TOKEN": "your-integration-token"
  }
}

Нужен npx

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

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

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

Номер в рейтинге: #109
Звезд на Github: 921
Форков на Github: 181
Загрузок: 51 299
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 19.10 в 08:36
Идентификатор: idw5lBxMJoPBcVPP
Категории: Заметки, Рабочее место и продуктивность

suekou/mcp-notion-server

Notion MCP Server

Highlights

Quick Start

Часто задаваемые вопросы

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

Notion MCP

n24q02m/better-notion-mcp

Badhansen/notion-mcp

ailenshen/apple-notes-mcp

bitbonsai/mcp-obsidian

henilcalagiya/mcp-apple-notes