Для чего этот сервер?

Этот MCP-сервер связывает AI-ассистента с Notion, позволяя управлять личным списком задач прямо в диалоге. Можно просматривать дела, добавлять новые и отмечать выполненные — всё через естественные команды, без ручного открытия Notion. Идеально, чтобы держать todo-list под рукой, не отвлекаясь от работы с AI.

Каталог MCP
Badhansen/notion-mcp

Badhansen/notion-mcp

от badhansen

MCP сервер для интеграции с Notion API: управляйте задачами из Claude Desktop. Добавляйте, просматривайте и обновляйте todo-записи. Полезен тем, кто ведёт список дел в Notion и хочет автоматизирова...

Github Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

notion-mcp

A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list.

Demo

Visual Guide

Notion MCP Query 1

Notion MCP Query 2

Notion MCP Query 1

Notion MCP Query 3

Notion MCP Query 1

Prerequisites

Python 3.11 or higher
A Notion account with API access
A Notion integration token
A Notion page where you want to manage your todo list
Claude Desktop clint

Setup

Installing via Smithery

To install Notion MCP for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Badhansen/notion-mcp --client claude

Clone the repository:

git clone https://github.com/Badhansen/notion-mcp.git
cd notion-mcp

Set up Python environment:

uv venv
source .venv/bin/activate
uv pip install -e .

Create a Notion integration:
- Go to https://www.notion.so/my-integrations
- Create new integration
- Copy the API key
Share your database/page with the integration:
- Open your notion workspace with a database/table present or a page.
- Click "..." menu → "Add connections"
- Select your integration (Search by name)

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить Badhansen/notion-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "badhansen-notion-mcp-zhv4qywwb3": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/username/Projects/Python/notion-mcp/src",
        "run",
        "server.py"
      ]
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "badhansen-notion-mcp-zhv4qywwb3": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/username/Projects/Python/notion-mcp/src",
        "run",
        "server.py"
      ]
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "badhansen-notion-mcp-zhv4qywwb3": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/Users/username/Projects/Python/notion-mcp/src",
        "run",
        "server.py"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"badhansen-notion-mcp-zhv4qywwb3\",\"type\":\"stdio\",\"command\":\"uv\",\"args\":[\"--directory\",\"/Users/username/Projects/Python/notion-mcp/src\",\"run\",\"server.py\"]}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "badhansen-notion-mcp-zhv4qywwb3": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/username/Projects/Python/notion-mcp/src",
        "run",
        "server.py"
      ]
    }
  }
}

Claude Code

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

claude mcp add badhansen-notion-mcp-zhv4qywwb3 -- uv --directory /Users/username/Projects/Python/notion-mcp/src run server.py

Либо через JSON-конфиг:

claude mcp add-json badhansen-notion-mcp-zhv4qywwb3 "{\"command\":\"uv\",\"args\":[\"--directory\",\"/Users/username/Projects/Python/notion-mcp/src\",\"run\",\"server.py\"]}"

Codex

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

codex mcp add badhansen-notion-mcp-zhv4qywwb3 -- uv --directory /Users/username/Projects/Python/notion-mcp/src run server.py

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.badhansen-notion-mcp-zhv4qywwb3]
command = "uv"
args = ["--directory", "/Users/username/Projects/Python/notion-mcp/src", "run", "server.py"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите Badhansen/notion-mcp, а в поле команды запуска — строку ниже:

uv --directory /Users/username/Projects/Python/notion-mcp/src run server.py

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "badhansen-notion-mcp-zhv4qywwb3": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/username/Projects/Python/notion-mcp/src",
        "run",
        "server.py"
      ]
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "badhansen-notion-mcp-zhv4qywwb3": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/username/Projects/Python/notion-mcp/src",
        "run",
        "server.py"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например badhansen-notion-mcp-zhv4qywwb3.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: badhansen-notion-mcp-zhv4qywwb3
    command: uv
    args:
      - "--directory"
      - "/Users/username/Projects/Python/notion-mcp/src"
      - "run"
      - "server.py"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "badhansen-notion-mcp-zhv4qywwb3": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/username/Projects/Python/notion-mcp/src",
        "run",
        "server.py"
      ]
    }
  }
}

Конфиг для установки сервера

{
  "command": "uv",
  "args": [
    "--directory",
    "/Users/username/Projects/Python/notion-mcp/src",
    "run",
    "server.py"
  ]
}

Информация о сервере

Номер в рейтинге: #194
Звезд на Github: 31
Форков на Github: 8
Язык реализации: Python
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 18.10 в 01:46
Идентификатор: rJfES-Po8mZBpqRx
Категории: Заметки, Рабочее место и продуктивность, Управление проектами

Похожие MCP-сервера

jimfilippou/things-mcp

от jimfilippou

MCP сервер для интеграции AI-ассистентов с macOS-приложением Things. Создавайте и обновляйте задачи (todo) и проекты, управляйте тегами, сроками и чеклистами через URL-схему. Помогает автоматизировать личную продуктивность и планирование.

Notion MCP

официальный

от makenotion

Notion MCP сервер даёт AI-агентам прямой доступ к Notion через API: читайте и редактируйте страницы в Markdown, делайте запросы к данным. Разработчики используют этот MCP инструмент для интеграции помощников с заметками и проектами, экономя токены.

n24q02m/better-notion-mcp

от n24q02m

Markdown-first MCP сервер для AI-агентов: управляет страницами, базами данных, блоками и комментариями Notion одним вызовом. Сокращает токены на 77%, поддерживает локальный и HTTP транспорт. Идеален для автоматизации Notion через ИИ.

suekou/mcp-notion-server

от suekou

MCP-сервер для интеграции Notion с AI-агентами: поиск, чтение, редактирование страниц и баз данных, создание элементов, выполнение запросов. Компактные ответы для AI-рабочих процессов. Для разработ...

dearlordylord/huly-mcp

от dearlordylord

MCP сервер для интеграции с Huly — платформой управления проектами и задачами. Позволяет создавать, обновлять и искать задачи, проекты, документы, комментарии. Полезен командам, использующим Huly в...

starecz/karea-mcp

от starecz

MCP-сервер Karea добавляет 44 инструмента для управления задачами прямо из кода: от создания до закрытия, с заметками, Jira и сводками. Полезен разработчикам, работающим в Claude Code или Cursor.