Notion

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

Продуктивность и workflow Совместная работа Управление контентом ★ 10 GitHub (10 ★)

Этот инструмент предоставляет сервер Model Context Protocol (MCP), который оборачивает официальный Notion SDK, позволяя AI-моделям беспрепятственно взаимодействовать с рабочими пространствами Notion. Подключив этот сервер к AI-ассистентам, таким как Claude, пользователи могут дать своим моделям возможность выполнять поиск, запрашивать базы данных, создавать и обновлять страницы, управлять блоками и многое другое напрямую в своём окружении Notion. Он поддерживает несколько вариантов конфигурации, включая аргументы командной строки, переменные окружения и JSON-конфигурации, что обеспечивает лёгкую интеграцию и настройку для различных AI-сценариев.

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

01Полная поддержка Notion API через официальный SDK

02Соответствие MCP для бесшовной AI-интеграции

03Комплексные инструменты для операций с Notion

04Надёжная обработка ошибок

05Простая настройка с помощью переменных окружения

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

01Предоставление AI-ассистентам возможности поиска и получения информации из баз данных Notion.

02Автоматизация создания и обновления страниц Notion с помощью AI-моделей.

03Управление контентными блоками и комментариями внутри Notion через AI-интеграции.

Notion MCP Server

A Model Context Protocol (MCP) server that exposes the official Notion SDK, allowing AI models to interact with Notion workspaces.

Quick Start

1. Set up your Notion integration

Go to https://www.notion.so/my-integrations
Create a new integration
Copy the API key

2. Connect your Notion pages to the integration

For your integration to access Notion content, you need to explicitly share your pages or databases with it:

Navigate to the Notion page or database you want to access through the integration
Click the "Share" button in the top-right corner
In the "Add people, groups, or integrations" field, select your integration from the dropdown list
Click "Invite"
Repeat for each page or database you want to make accessible

Note: An integration only has access to pages and databases that have been explicitly shared with it. Parent pages do not automatically grant access to child pages.

3. Add to your AI assistant

You can add this MCP server to Claude Desktop, Cursor AI, or Claude.ai using either of these configuration formats:

Command Line Format

npx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key

JSON Configuration Format

{
  "name": "Notion",
  "command": {
    "args": [
      "@ramidecodes/mcp-server-notion@latest",
      "-y",
      "--api-key=your-notion-integration-key"
    ],
    "env": {},
    "executable": "npx"
  }
}

Replace your-notion-integration-key with the API key from step 1.

Setup Instructions

Claude Desktop: Settings > Advanced > Model Context Protocol
Cursor AI: Settings > AI > MCP Servers
Claude.ai (Web): Profile > Settings > API & Integrations > Model Context Protocol

Available Tools

The server provides tools for interacting with Notion:

Search: Find pages or databases
Databases: Query and retrieve database entries
Pages: Create, retrieve, and update pages
Blocks: Manage content blocks (paragraphs, lists, etc.)
Users: List users and get user information
Comments: Create and list comments
Link Previews: Create link previews for URLs

Alternative Setup Methods

Using Environment Variables

Instead of passing the API key directly, you can use a .env file:

Create a .env file with:

NOTION_API_KEY=your-notion-integration-key

Run the server:

npx @ramidecodes/mcp-server-notion@latest -y

JSON Configuration with Environment Variables (for Claude Desktop)

You can also use environment variables in the JSON configuration format:

{
  "name": "Notion",
  "command": {
    "args": ["@ramidecodes/mcp-server-notion@latest", "-y"],
    "env": {
      "NOTION_API_KEY": "your-notion-integration-key"
    },
    "executable": "npx"
  }
}

Command Line Options

OPTIONS:
  -h, --help              Show help message
  -v, --version           Show version information
  --verbose               Enable verbose logging
  --env-path <path>       Path to .env file
  --api-key <key>         Notion API key
  -y                      Skip confirmation prompts

Troubleshooting

If you encounter "Failed to create client" errors:

On Windows, try using cmd /c before the npx command
On macOS/Linux, try using the full path to npx
Test the command in a terminal before adding it to your AI assistant

Common Issues

"No access to resource" errors: Make sure you've shared the specific Notion page or database with your integration (see step 2)
Integration not appearing in share menu: Try refreshing the page or restarting your browser
Limited capabilities: Check that your integration has the appropriate capabilities enabled in the Notion integration settings

Features

Full Notion API support through the official SDK
MCP compliant for seamless AI integration
Comprehensive tools for all Notion operations
Robust error handling with detailed messages
Easy configuration with environment variables

For detailed documentation on each tool, see the Tools Documentation.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Notion MCP Server

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

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

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

Перейдите на страницу My Integrations
Нажмите «Create new integration»
Скопируйте полученный API-ключ

2. Предоставьте интеграции доступ к страницам

Интеграция может работать только с теми страницами и базами данных, которые вы явно с ней «поделили»:

Откройте нужную страницу или базу данных в Notion
Нажмите «Share» (в правом верхнем углу)
В поле «Add people, groups, or integrations» выберите вашу интеграцию из списка
Нажмите «Invite»

Повторите для каждого ресурса, к которому нужен доступ. Обратите внимание: доступ к родительской странице не даёт автоматического доступа к дочерним.

3. Подключите к AI-ассистенту

Сервер можно добавить в Claude Desktop, Cursor AI или Claude.ai (веб-версия). Используйте один из форматов конфигурации.

Формат командной строки

npx @ramidecodes/mcp-server-notion@latest -y --api-key=ваш-ключ-интеграции

JSON-конфигурация (для Claude Desktop и других)

{
  "name": "Notion",
  "command": {
    "args": [
      "@ramidecodes/mcp-server-notion@latest",
      "-y",
      "--api-key=ваш-ключ-интеграции"
    ],
    "env": {},
    "executable": "npx"
  }
}

Замените ваш-ключ-интеграции на скопированный ранее API-ключ.

Где указать конфигурацию

Claude Desktop: Settings > Advanced > Model Context Protocol
Cursor AI: Settings > AI > MCP Servers
Claude.ai (веб): Profile > Settings > API & Integrations > Model Context Protocol

Доступные инструменты

Сервер предоставляет следующие группы инструментов для работы с Notion:

Search — поиск страниц и баз данных
Databases — запросы и получение записей из баз данных
Pages — создание, получение и обновление страниц
Blocks — управление блоками контента (параграфы, списки и т.д.)
Users — список пользователей и информация о них
Comments — создание и просмотр комментариев
Link Previews — создание превью для URL

Подробная документация по каждому инструменту — в Tools Documentation.

Альтернативные способы настройки

Использование .env файла

Создайте файл .env в рабочей директории:

NOTION_API_KEY=ваш-ключ-интеграции

Затем запустите сервер без указания ключа в команде:

npx @ramidecodes/mcp-server-notion@latest -y

JSON-конфигурация с переменными окружения

Для Claude Desktop можно передать ключ через env:

{
  "name": "Notion",
  "command": {
    "args": ["@ramidecodes/mcp-server-notion@latest", "-y"],
    "env": {
      "NOTION_API_KEY": "ваш-ключ-интеграции"
    },
    "executable": "npx"
  }
}

Параметры командной строки

Параметр	Описание
`-h, --help`	Показать справку
`-v, --version`	Показать версию
`--verbose`	Подробный вывод логов
`--env-path <путь>`	Путь к .env файлу
`--api-key <ключ>`	API-ключ Notion
`-y`	Пропустить подтверждения

Устранение неполадок

Ошибка «Failed to create client»

Windows: попробуйте добавить cmd /c перед командой npx
macOS/Linux: укажите полный путь к npx
Проверьте, что команда работает в терминале перед добавлением в AI-ассистент

Ошибка «No access to resource»

Убедитесь, что вы явно поделили нужную страницу или базу данных с интеграцией (шаг 2).

Интеграция не отображается в меню «Share»

Обновите страницу или перезапустите браузер.

Ограниченные возможности

Проверьте, что в настройках интеграции включены необходимые разрешения (capabilities).

Лицензия

Проект распространяется под лицензией Apache License 2.0. Подробнее — в файле LICENSE.

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

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

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

Notion MCP Server

Quick Start

1. Set up your Notion integration

2. Connect your Notion pages to the integration

3. Add to your AI assistant

Command Line Format

JSON Configuration Format

Setup Instructions

Available Tools

Alternative Setup Methods

Using Environment Variables

JSON Configuration with Environment Variables (for Claude Desktop)

Command Line Options

Troubleshooting

Common Issues

Features

License

Notion MCP Server

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

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

2. Предоставьте интеграции доступ к страницам

3. Подключите к AI-ассистенту

Формат командной строки

JSON-конфигурация (для Claude Desktop и других)

Где указать конфигурацию

Доступные инструменты

Альтернативные способы настройки

Использование .env файла

JSON-конфигурация с переменными окружения

Параметры командной строки

Устранение неполадок

Ошибка «Failed to create client»

Ошибка «No access to resource»

Интеграция не отображается в меню «Share»

Ограниченные возможности

Лицензия

Что такое Notion MCP Server?

Как подключить рабочее пространство Notion к серверу?

Что я могу делать с помощью Notion MCP Server?

Какие инструменты доступны через сервер?

Что делать, если я получаю ошибку 'No access to resource'?

Search

Parameters

Query Database

Parameters

Get Database

Parameters

Create Page

Parameters

Get Page

Parameters

Update Page

Parameters

Append Blocks

Parameters

Get Block

Parameters

Get Block Children

Parameters

Update Block

Parameters

Delete Block

Parameters

List Users

Get User

Parameters

Get Me

Create Comment

Parameters

List Comments

Parameters

Create Link Preview

Parameters

Комментарии