Notion

Интеграция ИИ с Notion через Notion MCP Server. Позволяет AI-агентам создавать страницы и оставлять комментарии на естественном языке. Протокол Model Context для Notion API. Получение контента по ID и многое другое!

Совместная работа Разработка API Продуктивность и workflow ★ 820 GitHub (820 ★)

Notion MCP Server предоставляет интерфейс для взаимодействия ИИ-инструментов с рабочими пространствами Notion через протокол Model Context Protocol (MCP). Настроив сервер с токеном интеграции Notion, пользователи могут давать ИИ-агентам команды на естественном языке или указывать идентификаторы контента для выполнения таких действий, как комментирование страниц, создание новых страниц и извлечение содержимого. Это обеспечивает бесшовную интеграцию данных Notion с ИИ-рабочими процессами.

Ключевые возможности

01Поддерживает извлечение контента из Notion по идентификаторам

02Использует инструкции на естественном языке для задач ИИ

03Реализует протокол Model Context Protocol (MCP) для API Notion

04Позволяет ИИ-агентам комментировать страницы Notion

05820 звёзд на GitHub

06Позволяет ИИ создавать новые страницы в Notion

Варианты использования

01Создание ИИ-ассистентов для взаимодействия с данными Notion

02Автоматизация обновления контента Notion с помощью ИИ

03Интеграция Notion с ИИ-инструментами для повышения продуктивности

Notion MCP Server

This project implements an MCP server for the Notion API.

Installation

1. Setting up Integration in Notion:

Go to https://www.notion.so/profile/integrations and create a new internal integration or select an existing one.

2. Adding MCP config to your client:

Add the following to your .cursor/mcp.json or claude_desktop_config.json (MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json)

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

Don't forget to replace ntn_**** with your integration secret. Find it from your integration configuration tab:

3. Connecting content to integration:

Ensure relevant pages and databases are connected to your integration.

To do this, you'll need to visit that page, and click on the 3 dots, and select "Connect to integration".

Examples

Using the following instruction

Comment "Hello MCP" on page "Getting started"

AI will correctly plan two API calls, v1/search and v1/comments, to achieve the task

Similarly, the following instruction will result in a new page named "Notion MCP" added to parent page "Development"

Add a page titled "Notion MCP" to page "Development"

You may also reference content ID directly

Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2

Development

Build

npm run build

Execute

npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server

Publish

npm publish --access public

MCP-сервер Notion

Сервер реализует протокол MCP (Model Context Protocol) для доступа к API Notion. Позволяет AI-агентам (например, Claude, Cursor) читать, писать и управлять страницами, базами данных и комментариями в Notion.

Установка

Создайте интеграцию в Notion Перейдите на страницу Интеграции Notion и создайте новую внутреннюю интеграцию (Internal Integration) или выберите существующую. Скопируйте секретный ключ интеграции (начинается с ntn_).
Настройте MCP-клиент Добавьте следующий блок в конфигурационный файл вашего MCP-клиента:
- Для Cursor: .cursor/mcp.json
- Для Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
```
{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\"}"
      }
    }
  }
}
```
Важно: Замените ntn_**** на ваш реальный секретный ключ интеграции. Версия API 2022-06-28 является обязательной.
Подключите контент к интеграции Для каждой страницы или базы данных Notion, к которым хотите дать доступ AI-агенту, откройте страницу, нажмите ••• (три точки) в правом верхнем углу и выберите «Подключить к интеграции» (Connect to integration) — укажите вашу интеграцию.

Примеры использования

После настройки вы можете давать AI-агенту команды на естественном языке. Сервер сам спланирует необходимые API-вызовы.

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

Оставь комментарий «Hello MCP» на странице «Getting started»

AI выполнит два запроса: v1/search (найти страницу) и v1/comments (добавить комментарий).
Создать новую страницу:

Добавь страницу с названием «Notion MCP» на страницу «Development»

Будет создана новая страница-подстраница внутри «Development».
Обращение по ID:

Получи содержимое страницы 1a6b35e6e67f802fa7e1d27686f017f2

Позволяет напрямую работать с известным идентификатором страницы или базы данных.

Разработка локальной версии

Если вы хотите модифицировать сервер или запускать его локально:

Клонируйте репозиторий.
Соберите проект:
```
npm run build
```

Запустите локальную версию:

npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server

Публикация (если вы вносите изменения):
```
npm publish --access public
```

Важные замечания

Сервер использует официальный Notion API. Для работы требуется активный секретный ключ интеграции.
Интеграция должна быть явно подключена к каждой странице или базе данных — автоматического доступа ко всему рабочему пространству нет.
Версия API (Notion-Version) должна быть 2022-06-28 или новее (но именно эта версия гарантирует совместимость).
При возникновении ошибок проверьте, что токен не истёк и что у интеграции есть права на чтение/запись для целевых страниц.

Источник: https://mcpmarket.com/server/notion-12