MN

makenotion/notion-mcp-server

Developer toolsОфициальный

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

4,7 тыс. stars 636 forks Качество 91 Тренд 82MIT

Официальное название MCP Server

Обзор

Для лучшего опыта, используйте наш официальный размещенный MCP-сервер. Он специально создан для предоставления агентов ИИ. Remote Notion MCP может выполнять поиск в рабочем пространстве и подключенных приложениях семантически, читать и редактировать страницы в Markdown и возвращать только наиболее релевантный контекст. Это означает меньше времени ожидания, меньше использования контекстного окна и более низкие затраты на токены. Он также использует OAuth и автоматически уважает существующие разрешения Notion каждого пользователя - без токенов API, конфигурации JSON, ручного обмена страницами или локального сервера для обслуживания. Узнайте больше и начните с документации Remote Notion MCP. Мы уделяем приоритетное внимание и оказываем только активную поддержку. В результате мы можем закатить этот локальный репозиторий MCP-сервера в будущем. Проблемы и запросы на вытягивание здесь активно не отслеживаются. - Пожалуйста, не подавайте вопросы, связанные с удаленным MCP здесь; вместо этого обратитесь в службу поддержки Notion. Этот проект реализует MCP-сервер для Notion API.

Обзор (машинный перевод)

[!ПРИМЕЧАНИЕ]

Для лучшего опыта используйте Remote Notion MCP, Наш официальный сервер MCP. Этот репозиторий представляет собой отдельный, самостоятельно размещенный MCP. Реализация сервера, который больше не поддерживается и не поддерживается. Пожалуйста. Вместо этого используйте Remote Notion MCP. Он специально создан для предоставления агентов ИИ ** Более быстрые результаты с использованием гораздо меньшего количества токенов.

MCP может выполнять поиск в рабочем пространстве и подключенных приложениях семантически, читать и Редактировать страницы в Markdown и возвращать только наиболее релевантный контекст. Это означает меньше

время ожидания, меньшее использование контекстного окна и более низкие затраты на токены. Также используется OAuth. • и автоматически соблюдает существующие разрешения Notion каждого пользователя без API; токены, конфигурация JSON, ручной обмен страницами или локальный сервер для обслуживания.

Особенность Удаленная нотация MCP Этот проект (локальный)
**Быстрый, размещенный опыт ** Запуски и обновления локально
** Токен-эффективные ответы** ✅ Ограниченный
Мощные инструменты, предназначенные для агентов ИИ Базовые инструменты, полученные из API
Семантический поиск в рабочем пространстве Notion Поиск по ключевым словам только
Поиск AI Connector по подключенным приложениям ✅ Недоступно

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Notion MCP Server

[!NOTE]

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.

This project implements an MCP server for the Notion API.


⚠️ Version 2.0.0 breaking changes

Version 2.0.0 migrates to the Notion API 2025-09-03 which introduces data sources as the primary abstraction for databases.

What changed

Removed tools (3):

  • post-database-query - replaced by query-data-source
  • update-a-database - replaced by update-a-data-source
  • create-a-database - replaced by create-a-data-source

New tools (7):

  • query-data-source - Query a data source (database) with filters and sorts
  • retrieve-a-data-source - Get metadata and schema for a data source
  • update-a-data-source - Update data source properties
Открыть полный README на GitHub

Установка

npx -y @notionhq/notion-mcp-server
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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