awkoy/notion-mcp-server

Developer tools

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

179 stars 41 forks Качество 92 Тренд 37MIT

Repository Install

awkoy/notion-mcp-server — это кандидат на MCP-сервер, импортированный из https://github.com/awkoy/notion-mcp-server.

Обзор

awkoy/notion-mcp-server — это кандидат на MCP-сервер, импортированный из https://github.com/awkoy/notion-mcp-server.

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

notion-mcp-server — это сервер протокола Model Context Protocol (MCP), который предоставляет Claude Code, Claude Desktop, Cursor, VS Code, Codex и любому другому клиенту MCP доступ к Notion с одним токеном. Ваш ИИ может искать, создавать и редактировать страницы, делать запросы в базы данных, комментировать и загружать файлы на простом языке.

Токен-аутентификация на каждом тарифном плане Notion, включено бесплатно. Вход в браузер не проходит, поэтому система также работает без головы: в CI, в cron jobs, фоновых агентах и на вашем сервере.
Мало контекста. Три инструмента стоят 1 005 токенов при подключении, против 17 163 у сервера с открытым исходным кодом Notion, а чтение страниц на 82% меньше. Бенчмарк →
Создано для агентов. Batched записывает с помощью атомарных отката и ключевых клавиш идемпотентности, повторных попыток на ограничениях скорости, markdown входе и выходе, а также ошибок, указывающих модели как исправить вызов.

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

1. Получите токен Notion. Откройте app.notion.com/developers/tokens → + Новый токен → назовите его, выберите рабочее пространство → Создать токен → скопировать значение ntn_…. Личный токен доступа видит всё, что вы видите, без совместного использования на странице. Не можете создать токен? Посмотрите вариант другого токена.

2. Установи.

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

README

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

Notion MCP Server — Connect Claude, Cursor, VS Code & Codex to Notion

notion-mcp-server is a Model Context Protocol (MCP) server that gives Claude Code, Claude Desktop, Cursor, VS Code, Codex and any other MCP client read/write access to Notion with one token. Your AI can search, create and edit pages, query databases, comment and upload files, in plain language.

Token auth on every Notion plan, Free included. No browser sign-in, so it also runs headless: in CI, cron jobs, background agents and on your own server.
Light on context. Its three tools cost 1,005 tokens at connection, against 17,163 for Notion’s open-source server, and page reads come back 82% smaller. Benchmark →
Built for agents. Batched writes with atomic rollback and idempotency keys, retry on rate limits, markdown in and out, and errors that tell the model how to fix the call.

Quick start

1. Get a Notion token. Open app.notion.com/developers/tokens → + New token → name it, pick your workspace → Create token → copy the ntn_… value. A Personal Access Token sees everything you can see, with no per-page sharing. Can’t create one? See the other token option.

2. Install it.

npx add-mcp notion-mcp-server --env NOTION_TOKEN=ntn_paste_your_token_here

add-mcp finds the MCP clients on your machine and writes the config for the ones you pick: Claude Code, Claude Desktop, Cursor, VS Code, Codex, Gemini CLI, Cline, Windsurf, Zed and more. Add -g to install for your user instead of the current project.

Keep the --env flag. Without it the entry is written without a token, and every call fails with an auth error.

Or install in one click:

Открыть полный README на GitHub

Установка

npx -y notion-mcp-server

Новичок в MCP? Начните с руководства на mcpskill.org →

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

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "notion-mcp-server"],
      "env": { "NOTION_TOKEN": "ntn_paste_your_token_here" }
    }
  }
}