Добавить сервер
Notion MCP
  1. Каталог MCP
  2. Notion MCP

Notion MCP

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

Notion MCP Server

Заметка

For the best experience, use Remote Notion MCP, our official hosted MCP server. This repository is a separate, self-hosted MCP server implementation that is no longer actively maintained or supported. Please use Remote Notion MCP instead. It is purpose-built to give AI agents faster results using far fewer tokens.

Remote Notion MCP can search your workspace and connected apps semantically, read and edit pages in Markdown, and return only the most relevant context. That means less time waiting, less context-window usage, and lower token costs. It also uses OAuth and automatically respects each user's existing Notion permissions—without API tokens, JSON configuration, manual page sharing, or a local server to maintain.

Feature Remote Notion MCP This project (local)
Fast, hosted experience ✅ Runs and updates locally
Token-efficient responses ✅ Limited
Powerful tools tailored for AI agents ✅ Basic API-derived tools
Semantic search across your Notion workspace ✅ Keyword search only
AI Connector search across connected apps ✅ Not available
Markdown-native page reading and editing ✅ Limited to two page-content tools
Seamless OAuth setup ✅ Manual token and JSON configuration
Respects each user's existing Notion permissions ✅ Manual integration permissions and page sharing
Active support and ongoing improvements ✅ Not actively supported

Learn more and get started in the Remote Notion MCP documentation.

We are prioritizing, and only providing active support for, Remote Notion MCP. 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.

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

Инструменты были проиндексированы:
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
2.5.2основная
2.5.1
2.5.0
2.4.1
2.4.0
2.3.1
2.2.1
2.2.0
2.1.0
2.0.0
1.9.1
1.9.0
1.8.1
1.8.0
1.7.0
1.6.0
1.5.0
1.4.0
1.3.0
1.2.0
1.1.0
1.0.0

Выберите клиент, чтобы установить Notion MCP:

Любой клиент

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

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

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

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

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

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

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

code --add-mcp "{\"name\":\"makenotion-notion-mcp-server-ep44mtsnx0\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@notionhq/notion-mcp-server\"],\"env\":{\"NOTION_TOKEN\":\"ntn_****\"}}"
ClaudeClaude 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": {
    "makenotion-notion-mcp-server-ep44mtsnx0": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "ntn_****"
      }
    }
  }
}
Claude CodeClaude Code

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

claude mcp add makenotion-notion-mcp-server-ep44mtsnx0 --env NOTION_TOKEN=ntn_**** -- npx -y @notionhq/notion-mcp-server

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

claude mcp add-json makenotion-notion-mcp-server-ep44mtsnx0 "{\"command\":\"npx\",\"args\":[\"-y\",\"@notionhq/notion-mcp-server\"],\"env\":{\"NOTION_TOKEN\":\"ntn_****\"}}"
CodexCodex

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

codex mcp add makenotion-notion-mcp-server-ep44mtsnx0 --env NOTION_TOKEN=ntn_**** -- npx -y @notionhq/notion-mcp-server

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

[mcp_servers.makenotion-notion-mcp-server-ep44mtsnx0]
command = "npx"
args = ["-y", "@notionhq/notion-mcp-server"]

[mcp_servers.makenotion-notion-mcp-server-ep44mtsnx0.env]
NOTION_TOKEN = "ntn_****"
PerplexityPerplexity

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

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

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

WindsurfWindsurf

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

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

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

{
  "mcpServers": {
    "makenotion-notion-mcp-server-ep44mtsnx0": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "ntn_****"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

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

mcpServers:
  - name: makenotion-notion-mcp-server-ep44mtsnx0
    command: npx
    args:
      - "-y"
      - "@notionhq/notion-mcp-server"
    env:
      NOTION_TOKEN: ntn_****
Zed

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

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

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

suekou/mcp-notion-server

suekou/mcp-notion-server

от suekou

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

TypeScript⭐ 921
n24q02m/better-notion-mcp

n24q02m/better-notion-mcp

от n24q02m

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

TypeScript⭐ 36
henilcalagiya/mcp-apple-notes

henilcalagiya/mcp-apple-notes

от henilcalagiya

MCP-сервер для автоматизации Apple Notes на macOS. Создавайте, редактируйте и удаляйте заметки и папки, ищите по ключевым словам. Работает с MCP-клиентами (Continue.dev, Claude Desktop). Основан на...

Python⭐ 52
smith-and-web/obsidian-mcp-server

smith-and-web/obsidian-mcp-server

от smith-and-web

MCP-сервер для интеграции AI-ассистентов с Obsidian: создавайте, читайте, редактируйте заметки, управляйте тегами и ищите по хранилищу через естественный язык. Полезен для автоматизации работы с за...

TypeScript⭐ 19
Badhansen/notion-mcp

Badhansen/notion-mcp

от badhansen

MCP сервер для интеграции с Notion API: управляйте задачами из Claude Desktop. Добавляйте, просматривайте и обновляйте todo-записи. Полезен тем, кто ведёт список дел в Notion и хочет автоматизирова...

Python⭐ 31
bitbonsai/mcp-obsidian

bitbonsai/mcp-obsidian

от bitbonsai

MCPVault — AI-мост для Obsidian по стандарту MCP. Подключает Claude, ChatGPT и других ассистентов к вашим заметкам с безопасным доступом и защитой frontmatter. Без привязки к одному провайдеру.

TypeScript⭐ 1697
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин