Каталог MCP
makenotion

makenotion/notion-mcp-server

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

API-create-a-comment

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

Параметры

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

API-create-a-data-source

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

Параметры

parentanyобязательный
propertiesanyобязательный
titlearray

API-delete-a-block

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

Параметры

block_idstringобязательный
Identifier for a Notion block

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

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

Параметры

block_idstringобязательный
Identifier for a [block](ref:block)
start_cursorstring
If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.
page_sizeinteger
The number of items from the full list desired in the response. Maximum: 100

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

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

Параметры

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

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

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

Параметры

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

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

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

Параметры

start_cursorstring
If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.
page_sizeinteger
The number of items from the full list desired in the response. Maximum: 100

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

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

Параметры

data_source_idstringобязательный
Identifier for a Notion data source
start_cursorstring
page_sizeinteger

API-move-page

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

Параметры

page_idstringобязательный
Identifier for a Notion page
parentanyобязательный

API-patch-block-children

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

Параметры

block_idstringобязательный
Identifier for a [block](ref:block). Also accepts a [page](ref:page) ID.
childrenarrayобязательный
Child content to append to a container block as an array of [block objects](ref:block)
afterstring
The ID of the existing block that the new block should be appended after.

API-patch-page

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

Параметры

page_idstringобязательный
The identifier for the Notion page to be updated.
propertiesany
in_trashboolean
Set to true to delete a block. Set to false to restore a block.
archivedboolean
iconany
coverany

API-post-page

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

Параметры

parentanyобязательный
propertiesanyобязательный
childrenarray
The content to be rendered on the new page, represented as an array of [block objects](https://developers.notion.com/reference/block).
iconstring
The icon of the new page. Either an [emoji object](https://developers.notion.com/reference/emoji-object) or an [external file object](https://developers.notion.com/reference/file-object)..
coverstring
The cover image of the new page, represented as a [file object](https://developers.notion.com/reference/file-object).

API-post-search

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

Параметры

querystring
The text that the API compares page and database titles against.
sortany
filterany
start_cursorstring
A `cursor` value returned in a previous response that If supplied, limits the response to results starting after the `cursor`. If not supplied, then the first page of results is returned. Refer to [pagination](https://developers.notion.com/reference/intro#pagination) for more details.
page_sizeinteger
The number of items from the full list to include in the response. Maximum: `100`.

API-query-data-source

Notion | Query a data source Error Responses: 400: Bad request

Параметры

data_source_idstringобязательный
Identifier for a Notion data source (database)
filter_propertiesarray
A list of page property value IDs to limit the response
filterany
sortsarray
start_cursorstring
page_sizeinteger
archivedboolean
in_trashboolean

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

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

Параметры

block_idstringобязательный
Identifier for a Notion block

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

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

Параметры

block_idstringобязательный
Identifier for a Notion block or page
start_cursorstring
If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.
page_sizeinteger
The number of items from the full list desired in the response. Maximum: 100

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

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

Параметры

database_idstringобязательный
Identifier for a Notion database

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

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

Параметры

data_source_idstringобязательный
Identifier for a Notion data source

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

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

Параметры

page_idstringобязательный
Identifier for a Notion page
filter_propertiesstring
A list of page property value IDs associated with the page. Use this param to limit the response to a specific page property value or values. To retrieve multiple properties, specify each page property ID. For example: `?filter_properties=iAk8&filter_properties=b7dh`.

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

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

Параметры

page_idstringобязательный
Identifier for a Notion page
property_idstringобязательный
Identifier for a page [property](https://developers.notion.com/reference/page#all-property-values)
page_sizeinteger
For paginated properties. The max number of property item objects on a page. The default size is 100
start_cursorstring
For paginated properties.

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

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

Параметры

page_idstringобязательный
Identifier for a Notion page (or block) to read or update as markdown.
include_transcriptboolean
Whether to include meeting note transcripts. When false (default), a placeholder with the meeting note URL is shown instead of the full transcript.

API-update-a-block

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

Параметры

block_idstringобязательный
Identifier for a Notion block
typeany
archivedboolean
Set to true to archive (delete) a block. Set to false to un-archive (restore) a block.

API-update-a-data-source

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

Параметры

data_source_idstringобязательный
Identifier for a Notion data source
titlearray
descriptionarray
propertiesany

API-update-page-markdown

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

Параметры

page_idstringобязательный
Identifier for a Notion page (or block) to read or update as markdown.
typeenumобязательный
The kind of edit to apply. Prefer `replace_content` (overwrite the whole page) or `update_content` (targeted find-and-replace). `insert_content` and `replace_content_range` are deprecated.
replace_contentupdate_contentinsert_contentreplace_content_range
replace_contentany
update_contentany
insert_contentany
replace_content_rangeany

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

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

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

Также makenotion/notion-mcp-server можно установить в Cursor по ссылке автоматически.

FAQ

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

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

Что он умеет?

Сервер работает со страницами — читает и редактирует их содержимое в Markdown, создаёт, обновляет свойства, перемещает страницы между родителями; управляет блоками — читает, добавляет, обновляет, удаляет их; запрашивает, создаёт и обновляет data sources (бывшие базы данных), получает их метаданные и шаблоны; читает и создаёт комментарии; получает информацию о пользователях, ищет по заголовку, читает свойства страниц.

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

Номер в рейтинге: #32
Звезд на Github: 4540
Форков на Github: 604
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Да
Дата обновления данных: 19.07 в 08:58
Идентификатор: RncO4E_I3uEMnUlp
Категории: CMS, Автоматизация приложений, Базы данных, Документация, Заметки, Знания и память, Инструменты для разработчиков, Коммуникации, Поиск, Рабочее место и продуктивность, Управление проектами

Другие проверенные MCP-сервера

thinq-connect/thinqconnect-mcp

официальный

Официальный MCP-сервер для управления бытовой техникой LG ThinQ. Позволяет отслеживать статус устройств, запрашивать доступные команды и управлять ими (вкл/выкл, настройка температуры и др.) через ...

higress-group/higress-ops-mcp-server

официальный

Higress OPS MCP сервер управляет конфигурацией и мониторингом API-шлюза Higress через агентный поток на LangGraph. Помогает DevOps-инженерам автоматизировать работу с Higress Console API.

atilaahmettaner/tradingview-mcp

MCP сервер для рыночных данных и технического анализа — акции, крипта, форекс и фьючерсы. Включает скринеры, бэктестинг и 30+ инструментов. Работает с Claude, ChatGPT, Cursor — всё в одном сервере.

thingsboard/thingsboard-mcp

официальный

MCP сервер для ThingsBoard: управляйте IoT-устройствами, телеметрией и тревогами через естественный язык. 120+ инструментов для автоматизации операций с сущностями и OTA-пакетами. Идеален для DevOp...

posthog/mcp

официальный

MCP сервер для интеграции с PostHog — платформой продуктовой аналитики. Позволяет запрашивать данные о событиях, сессиях и пользователях через ИИ-ассистентов (Claude, Cursor, VS Code). Полезен продакт-менеджерам и разработчикам для быстрого анализа.

agenticmail/agenticmail

официальный

MCP сервер наделяет AI-агентов реальными email и номерами телефонов для отправки и получения писем, SMS и кодов верификации. Встроенная память, голосовые вызовы и медиа-инструменты расширяют их возможности.