Сервер Notion MCP

Дружелюбный к ИИ MCP-сервер для Notion API. Он помогает агентам находить, читать, запрашивать и обновлять рабочие пространства Notion, сохраняя ответы достаточно компактными для повседневных рабочих процессов ИИ.

Этот сервер ориентирован на Notion API версии 2026-03-11 и использует текущую модель баз данных/источников данных. Он предоставляет MCP-инструменты, промпты, ресурсы, структурированные результаты инструментов и необязательные приложения MCP для интерактивных рабочих процессов в Notion.

Ключевые особенности

• Поиск и обнаружение целей с помощью notion_find.
• Компактное чтение страниц со стабильными идентификаторами блоков через notion_read_page.
• Просмотр схемы источников данных с помощью notion_inspect_data_source.
• Запросы к источникам данных с учетом схемы и создание элементов с помощью простых значений.
• Простые инструменты редактирования страниц для абзацев, заголовков, списков, задач, цитат, выносков, блоков кода, разделителей и безопасного добавления Markdown.
• Инструменты для работы с сырым Notion API для продвинутых операций с блоками, страницами, базами данных, источниками данных, комментариями и пользователями.
• Необязательные приложения MCP: Проводник источников данных и Рабочая область страниц.

Быстрый старт

Добавьте этот сервер в хост MCP, например Claude Desktop:

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

Перезапустите хост MCP после сохранения конфигурации.

Руководство по настройке

1. Создание интеграции Notion

Откройте панель управления интеграциями Notion и создайте новую внутреннюю интеграцию.

2. Настройка возможностей

Предоставьте только те возможности, которые вам нужны:

• Чтение контента: требуется для поиска, чтения страниц, получения источников данных и запросов.
• Вставка контента: требуется для создания страниц/элементов и добавления блоков.
• Обновление контента: требуется для обновления страниц, блоков и схем источников данных.
• Чтение комментариев / Вставка комментариев: требуется только для инструментов работы с комментариями.
• Информация о пользователях: требуется только при использовании инструментов поиска пользователей.

Для полной функциональности при настройке включите чтение, вставку и обновление контента. Добавьте возможности для комментариев или пользователей только если планируете использовать эти инструменты.

3. Предоставление доступа к контенту

Откройте вкладку Доступ к контенту для вашей интеграции, затем выберите страницы или базы данных, к которым серверу MCP должен быть разрешен доступ для чтения или редактирования.

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

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

4. Копирование токена внутренней интеграции

Скопируйте секрет интеграции. Это значение станет NOTION_API_TOKEN в конфигурации вашего хоста MCP.

5. Настройка вашего хоста MCP

Для Cursor, Claude Desktop и других хостов MCP добавьте эту конфигурацию сервера в настройки MCP:

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

Для локально скомпилированной версии:

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": ["/absolute/path/to/suekou-mcp-notion-server/build/index.js"],
      "env": {
        "NOTION_API_TOKEN": "secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Рекомендуемый рабочий процесс

1. Используйте notion_find для поиска страницы или источника данных.
2. Используйте notion_read_page для получения контекста страницы и идентификаторов редактируемых блоков.
3. Используйте notion_inspect_data_source перед запросом или созданием элементов источника данных.
4. Используйте notion_query_data_source_by_values и notion_create_data_source_item_from_values для типичных задач работы с источниками данных.
5. Используйте notion_append_markdown, notion_append_content, notion_update_content или notion_update_content_batch для обычного редактирования страниц.
6. Прибегайте к инструментам для работы с сырым JSON только тогда, когда упрощенные инструменты не покрывают нужную вам структуру Notion API.

Для разработчиков

Эти справочные материалы предназначены в основном для разработки, настройки и продвинутых рабочих процессов MCP:

• Конфигурация: переменные среды, аргументы командной строки, примеры хостов MCP, команды для разработки и устранение неполадок.
• Инструменты: полный справочник по инструментам, сгруппированный по областям рабочего процесса.
• Рабочие процессы: практические руководства по чтению, записи, источникам данных, миграции и обработке ошибок.
• Приложения MCP: подробная информация об интерактивном Проводнике источников данных и Рабочей области страниц.

Разработка

Этот проект использует Node.js 22 или новее и pnpm.

pnpm install --frozen-lockfile
pnpm run build
pnpm test

Используйте инспектор MCP во время локальной разработки:

pnpm run inspector

Лицензия

Этот сервер MCP распространяется под лицензией MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Подробности см. в файле LICENSE в репозитории проекта.