Notion

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

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

Notion предоставляет сервер Model Context Protocol (MCP), который обеспечивает бесшовную интеграцию с Notion. Он позволяет языковым моделям взаимодействовать с вашим рабочим пространством Notion, предоставляя стандартизированные инструменты для поиска, чтения, создания и об

Notion MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with Notion. This server enables Language Models to interact with your Notion workspace through standardized tools for searching, reading, creating, and updating pages and databases.

🌟 Key Features

Page Operations

🔍 Search through your Notion workspace
📝 Create new pages with rich markdown content
📖 Read page content with clean formatting
🔄 Update existing pages
💬 Add and retrieve comments
🧱 Block-level operations (update, delete)

Enhanced Markdown Support

Multiple heading levels (H1-H3)
Code blocks with language support
Interactive todo items with checkbox states
Blockquotes with multi-line support
Horizontal dividers
Images with captions
Nested bullet points

Database Operations

Create and manage databases
Add and update database items
Query with filters and sorting
Support for various property types:
- Title, Rich text, Number
- Select, Multi-select
- Date, Checkbox
- And more!

🚀 Getting Started

Prerequisites

Node.js (v16 or higher)
Notion API key
MCP-compatible client (e.g., Claude Desktop)

Installation

Clone the repository:

git clone https://github.com/v-3/notion-server.git
cd notion-server

Install dependencies:

npm install

Set up your environment:

# Create .env file
echo "NOTION_API_KEY=your_notion_api_key_here" > .env

# Or export directly
export NOTION_API_KEY=your_notion_api_key_here

Build the server:

npm run build

🔧 Configuration

Claude Desktop Setup

Update your Claude Desktop configuration (claude_desktop_config.json):

{
    "mcpServers": {
        "notion": {
            "command": "node",
            "args": ["/absolute/path/to/notion-server/build/index.js"],
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            }
        }
    }
}

Restart Claude Desktop to apply changes

🛠️ Available Tools

Page Operations

// Search pages
{
    query: string // Search query
}

// Read page
{
    pageId: string // ID of the page to read
}

// Create page
{
    title?: string,      // Page title
    content?: string,    // Page content in markdown
    parentPageId: string // Parent page ID
    properties?: object  // For database items
}

// Update page
{
    pageId: string,   // Page ID to update
    content: string,  // New content
    type?: string    // Content type
}

Database Operations

// Create database
{
    parentPageId: string,
    title: string,
    properties: object
}

// Query database
{
    databaseId: string,
    filter?: object,
    sort?: object
}

🔐 Setting Up Notion Access

Creating an Integration

Visit Notion Integrations
Click "New integration"
Configure permissions:
- Content: Read, Update, Insert
- Comments: Read, Create
- User Information: Read

Connecting Pages

Open your Notion page
Click "..." menu → "Connections"
Add your integration
Repeat for other pages as needed

📝 Usage Examples

Creating a Page

const result = await notion.create_page({
  parentPageId: "page_id",
  title: "My Page",
  content: "# Welcome\nThis is a test page."
});

Querying a Database

const result = await notion.query_database({
  databaseId: "db_id",
  filter: {
    property: "Status",
    select: {
      equals: "In Progress"
    }
  }
});

🤝 Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch
Submit a Pull Request

📜 License

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

🙏 Acknowledgments

This project has been significantly improved by sweir1/notion-server, who has made following updates:

Enhanced markdown support with more block types
Comprehensive database operations
Improved error handling and debugging
Better property handling for database items
Cleaner page output formatting

To use sweir1's version, you can clone their repository:

git clone https://github.com/sweir1/notion-server.git

Notion MCP Server

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

Возможности

Операции со страницами

🔍 Поиск по рабочему пространству
📝 Создание страниц с поддержкой Markdown
📖 Чтение содержимого с чистым форматированием
🔄 Обновление существующих страниц
💬 Добавление и получение комментариев
🧱 Операции на уровне блоков (обновление, удаление)

Расширенная поддержка Markdown

Заголовки H1–H3
Блоки кода с указанием языка
Интерактивные todo-элементы с состояниями чекбоксов
Цитаты с поддержкой многострочного текста
Горизонтальные разделители
Изображения с подписями
Вложенные маркированные списки

Операции с базами данных

Создание и управление базами данных
Добавление и обновление элементов
Запросы с фильтрацией и сортировкой
Поддержка различных типов свойств: Title, Rich text, Number, Select, Multi-select, Date, Checkbox и других

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

Предварительные требования

Node.js v16 или выше
API-ключ Notion
MCP-совместимый клиент (например, Claude Desktop)

Установка

Клонируйте репозиторий:

git clone https://github.com/v-3/notion-server.git
cd notion-server

Установите зависимости:
```
npm install
```
Настройте переменные окружения:
```
echo "NOTION_API_KEY=your_notion_api_key_here" > .env
```
Или экспортируйте напрямую:
```
export NOTION_API_KEY=your_notion_api_key_here
```
Соберите сервер:
```
npm run build
```

Конфигурация для Claude Desktop

Отредактируйте файл claude_desktop_config.json:

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": ["/absolute/path/to/notion-server/build/index.js"],
      "env": {
        "NOTION_API_KEY": "your_notion_api_key_here"
      }
    }
  }
}

После изменений перезапустите Claude Desktop.

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

Операции со страницами

Поиск страниц: { query: string }
Чтение страницы: { pageId: string }
Создание страницы: { title?: string, content?: string, parentPageId: string, properties?: object }
Обновление страницы: { pageId: string, content: string, type?: string }

Операции с базами данных

Создание базы данных: { parentPageId: string, title: string, properties: object }
Запрос к базе данных: { databaseId: string, filter?: object, sort?: object }

Настройка доступа к Notion

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

Перейдите на страницу Notion Integrations
Нажмите «New integration»
Настройте разрешения:
- Content: Read, Update, Insert
- Comments: Read, Create
- User Information: Read

Подключение страниц

Откройте нужную страницу в Notion
Нажмите «...» → «Connections»
Добавьте вашу интеграцию
Повторите для других страниц

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

Создание страницы

const result = await notion.create_page({
  parentPageId: "page_id",
  title: "My Page",
  content: "# Welcome\nThis is a test page."
});

Запрос к базе данных

const result = await notion.query_database({
  databaseId: "db_id",
  filter: {
    property: "Status",
    select: {
      equals: "In Progress"
    }
  }
});

Вклад в проект

Приветствуются любые улучшения. Пожалуйста:

Форкните репозиторий
Создайте ветку для новой функциональности
Отправьте Pull Request

Лицензия

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

Благодарности

Проект значительно улучшен благодаря работе sweir1/notion-server, который добавил:

Расширенную поддержку Markdown с новыми типами блоков
Полноценные операции с базами данных
Улучшенную обработку ошибок и отладку
Более качественную обработку свойств элементов баз данных
Чистое форматирование вывода страниц

Для использования версии sweir1 клонируйте репозиторий:

git clone https://github.com/sweir1/notion-server.git

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

Notion MCP Server

🌟 Key Features

Page Operations

Enhanced Markdown Support

Database Operations

🚀 Getting Started

Prerequisites

Installation

🔧 Configuration

Claude Desktop Setup

🛠️ Available Tools

Page Operations

Database Operations

🔐 Setting Up Notion Access

Creating an Integration

Connecting Pages

📝 Usage Examples

Creating a Page

Querying a Database

🤝 Contributing

📜 License

🙏 Acknowledgments

Notion MCP Server

Возможности

Операции со страницами

Расширенная поддержка Markdown

Операции с базами данных

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

Предварительные требования

Установка

Конфигурация для Claude Desktop

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

Операции со страницами

Операции с базами данных

Настройка доступа к Notion

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

Подключение страниц

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

Создание страницы

Запрос к базе данных

Вклад в проект

Лицензия

Благодарности

Какие функции предлагает Notion MCP Server?

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

Какие типы свойств базы данных поддерживаются?

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

Что нужно для работы с Notion MCP Server?

Search Pages

Parameters

Read Page

Parameters

Create Page

Parameters

Update Page

Parameters

Retrieve Comments

Parameters

Add Comment

Parameters

Create Database

Parameters

Query Database

Parameters

Update Block

Parameters

Delete Block

Parameters

Update Database Item

Parameters

Retrieve Database

Parameters

Update Database

Parameters

Комментарии