Hermes Agent подключается к Notion через официальный скилл productivity-notion и API: агент умеет создавать страницы из Markdown, вести базы данных задач, искать по рабочему пространству и обновлять статусы по вашей просьбе. В статье — пошаговая настройка интеграции, готовые промпты для управления проектами и заметками и разбор ошибок, из-за которых Notion возвращает 404.
Что такое связка Hermes Agent и Notion
Hermes Agent — это опенсорсный ИИ-агент от Nous Research, который не просто отвечает в чате, а сам выполняет действия на вашем компьютере или сервере: запускает команды, обращается к API, работает с файлами, общается в Telegram и Discord и выполняет задачи по расписанию.
Notion — это рабочее пространство для заметок, документов, баз данных и управления проектами, где команда хранит знания, задачи и документацию в виде страниц и баз (в новых версиях API они называются data sources).
Связка этих двух инструментов закрывает типичную проблему: Notion отлично хранит информацию, но сам по себе не наполняет и не поддерживает её в актуальном состоянии. Hermes Agent становится посредником: вы описываете задачу обычным языком — «запиши итоги встречи», «покажи задачи в работе», «собери отчёт по проекту» — а агент превращает её в конкретные операции с вашими страницами и базами.
В отличие от ручного копирования текста в Notion, Hermes работает с API напрямую: это значит, что страницы создаются с правильной структурой, задачи попадают в нужные базы с заполненными свойствами (статус, срок, исполнитель), а повторяющиеся операции можно автоматизировать по расписанию.
Что умеет Hermes Agent в Notion: возможности скилла productivity-notion
За интеграцию отвечает встроенный скилл productivity-notion версии 2.0.0 — он устанавливается вместе с Hermes Agent по умолчанию (источник: документация скилла). Лицензия MIT, поддерживаются Linux, macOS и Windows.
Скилл даёт агенту два канала работы с Notion, и один токен интеграции подходит для обоих:
ntn CLI — официальная командная строка Notion. Короткий синтаксис, загрузка файлов одной строкой, поддержка Notion Workers. Доступна на macOS и Linux, поддержка Windows заявлена как «скоро».ntn не установлен.Что агент умеет делать в Notion:
ntn это делается одной командой.ntn и тариф Business или Enterprise): синхронизации, вебхуки и инструменты для Notion Custom Agents.По данным документации, все операции идут через Notion API версии 2025-09-03, и API ограничивает частоту запросов примерно 3 запросами в секунду — это платформенное ограничение, CLI его не обходит.
Как подключить Notion к Hermes Agent: пошаговая инструкция
Настройка занимает 10–15 минут и состоит из четырёх шагов. Всё делается один раз, дальше агент работает с вашим пространством без участия человека.
Шаг 1. Создайте внутреннюю интеграцию Notion
ntn_ или secret_. Это ваш интеграционный токен, храните его как пароль.Создавать интеграцию может владелец рабочего пространства: в Notion доступ к разделу интеграций есть только у владельцев и администраторов.
Шаг 2. Сохраните токен в окружении Hermes
Токен кладётся в файл .env вашего Hermes-профиля (обычно это ${HERMES_HOME}/.env, где HERMES_HOME указывает на папку профиля, например ~/.hermes):
NOTION_API_KEY=ntn_your_key_here
Файл .env — стандартное место для секретов Hermes: он не попадает в историю чата и в переписку. Не передавайте токен в тексте сообщений агенту и не кладите его в файлы, которые могут попасть в git.
Шаг 3. Откройте интеграции доступ к страницам и базам
Самый частый источник ошибок. Notion API возвращает ошибку 404 даже на существующую страницу, если она не расшарена с вашей интеграцией. Для каждой страницы или базы, с которой должен работать агент:
... → Connect to (Подключить).Достаточно расшарить «родительские» страницы: доступ к вложенным страницам интеграция получает вместе с родительской.
Шаг 4. Установите `ntn` (рекомендуется на macOS и Linux)
curl -fsSL https://ntn.dev | bash
Либо через npm (нужны Node 22+ и npm 10+):
npm install --global ntn
ntn --version
Логин через браузер (ntn login) не нужен — агент работает с интеграционным токеном. Достаточно указать переменные окружения:
export NOTION_API_TOKEN=$NOTION_API_KEY
export NOTION_KEYRING=0
Эти строки добавляются в shell-профиль или в .env профиля Hermes, чтобы каждая сессия их наследовала. NOTION_KEYRING=0 запрещает CLI обращаться к системной связке ключей и хранит учётные данные в файле ~/.config/notion/auth.json — так интеграция работает без графического окружения, например на сервере.
Шаг 5. Проверьте подключение
Попросите агента выполнить простую команду — например, показать список пользователей пространства или найти страницу по названию:
Проверь подключение к Notion: покажи, какие пользователи есть в рабочем пространстве.
Если агент вернул список — интеграция готова к работе.
Как Hermes работает с Notion: два технических пути
Понимать разницу между путями полезно, чтобы знать, что происходит «под капотом» и как чинить проблемы.
| Задача | macOS / Linux | Windows |
|---|---|---|
| Чтение и запись страниц, поиск, запросы к базам | `ntn api …` | curl |
| Прочитать страницу для саммари | `ntn api v1/pages/{id}/markdown` | curl `/markdown` |
| Загрузить файл | `ntn files create | HTTP-флоу из 3 шагов |
| Создать Worker (синхронизация, вебхук) | `ntn workers …` | WSL2 + `ntn workers …` |
На практике пользователю не нужно запоминать команды: Hermes сам выбирает доступный путь. Агент сначала проверяет, установлен ли ntn, и работает через него, а если CLI нет — переходит на HTTP-запросы. Для Windows рекомендуется использовать curl (встроен в Windows 10+) или установить ntn внутри WSL2.
Ключевая деталь нового API: то, что в интерфейсе Notion называется «базой данных», в API версии 2025-09-03 называется data source, и у базы два идентификатора: database_id используется при создании записей, а data_source_id — при запросах и фильтрации. Агент разбирается в этом сам, но если вы видите в логах термины data_sources — это нормальная работа с базами.
Пять сценариев управления проектами и заметками через AI
1. Заметки со встреч и совещаний
Самый быстрый способ почувствовать интеграцию. После созвона вы пересылаете Hermes расшифровку или просто диктуете итоги, и агент создаёт аккуратную страницу в Notion:
Запиши заметки по итогам встречи с клиентом в папку "Встречи" в Notion.
Структура: дата, участники, договорённости, следующие шаги с исполнителями.
Текст: обсудили запуск лендинга, бюджет утверждён, дизайн-макет нужен к пятнице.
Hermes создаст страницу из Markdown с заголовками и списками — вам останется открыть её в Notion и убедиться, что ничего не потерялось. Дальше эту же страницу можно дополнять: агент умеет добавлять блоки к уже существующей странице, например решение, принятое на следующий день после встречи.
2. Ведение базы задач проекта
Если проект ведётся в базе Notion со свойствами «Статус», «Приоритет», «Дедлайн», агент становится руками команды:
Найди в базе "Задачи проекта" все карточки со статусом "В работе" и выведи
список: название, ответственный, дедлайн.
Пометь задачу "Подготовить презентацию для инвестора" как "Done".
Добавь в базу "Задачи" новую запись: название "Согласовать договор с подрядчиком",
статус "Todo", приоритет "Высокий", дедлайн 2026-10-15.
Агент формирует запрос с фильтрами по свойству Status, обновляет свойства конкретной записи или создаёт новую с типизированными полями. Это работает как «голосовой ассистент для трекера»: вы не открываете Notion ради каждой мелкой правки, а отдаёте команду в чат.
3. Регулярные отчёты в Notion по расписанию
Самый ценный сценарий для руководителя или фрилансера — Hermes сам наполняет Notion отчётами по расписанию, используя механизм cron-задач Hermes. Пример: каждую пятницу агент собирает итоги недели и кладёт их в базу «Отчёты»:
Каждую пятницу в 17:00 собери список задач со статусом "Done" за неделю,
сгруппируй по проектам и создай в базе "Отчёты" страницу "Итоги недели — дата".
Аналогично настраиваются утренние сводки: «утром покажи задачи с дедлайном сегодня» или «перенеси просроченные задачи на завтра и напиши мне, что перенёс». Notion перестаёт быть местом, куда нужно заходить «руками», — данные приходят в него сами, а вы получаете только уведомление о результате.
4. Проектная вики и база знаний
Для документации проектов удобно держать в Notion вики, а пополнять её через Hermes. Агент может конспектировать статьи, письма и обсуждения и складывать структурированные заметки в нужный раздел вики. Технически это работает через чтение страницы как Markdown (endpoint /markdown) — агент получает чистый текст без лишней разметки и перерабатывает его в нужный формат.
Прочитай страницу "Бриф клиента" в Notion, выдели из неё требования к проекту
и создай страницу "Требования" в базе "База знаний" со свойствами:
источник = Бриф, статус = Черновик.
5. Лёгкая CRM на базе Notion
Notion часто используют как простую CRM: база с заявками, статусами сделок и комментариями. Hermes в этой схеме выполняет работу менеджера по вводу данных: заявка пришла на почту — агент разобрал письмо и создал карточку в базе; клиент написал в Telegram — агент обновил статус и добавил комментарий. Внутри одной сессии Hermes комбинирует разные навыки, поэтому цепочка «почта → Notion → ответ клиенту» выполняется без ручного копирования.
Альтернативный способ: Notion MCP и готовые коннекторы
Помимо встроенного скилла, Notion можно подключить через Model Context Protocol (MCP) — тот же механизм, что описан в статье «MCP-протокол в Hermes». Notion выпустила собственный MCP-сервер: по оценке в документации Hermes, он примерно на 91% эффективнее по расходу токенов при операциях с базами данных по сравнению с предыдущей версией — это заметно, когда агент часто обращается к базам.
MCP-подход удобен, когда нужен потоковый доступ к Notion прямо внутри сессии и больше готовых действий. Например, сервис Composio предоставляет готовый Notion-коннектор для Hermes: 45 инструментов и 13 триггеров — создание и дублирование страниц, управление базами, комментарии, архивация и восстановление, работа с блоками и вложениями (источник: Composio, страница интеграции Notion с Hermes).
Подключение MCP-сервера в Hermes выполняется в конфигурационном файле config.yaml профиля:
mcp_servers:
composio:
url: "https://connect.composio.dev/mcp"
headers:
x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
connect_timeout: 60
timeout: 180
После перезапуска агента вы просите его подключиться к Notion и авторизовать доступ — дальше инструменты доступны по запросу.
Что выбрать: скилл или MCP? Для типовых задач — заметки, задачи, отчёты, базы знаний — достаточно встроенного скилла: он уже стоит по умолчанию, не требует сторонних сервисов и работает с вашим токеном. MCP имеет смысл подключать, когда нужны десятки разных операций (комментарии к обсуждениям, дублирование страниц, сложная работа с блоками) или когда вы всё равно используете MCP-инфраструктуру для других сервисов.
Notion Workers: автоматизация внутри Notion (продвинутый уровень)
Для сложных сценариев скилл поддерживает Notion Workers — программы на TypeScript, которые хостит сам Notion. Один Worker может совмещать три типа возможностей:
Worker разворачивается командой ntn workers deploy. Важные ограничения из документации: развёртывание Workers требует тарифа Business или Enterprise, а CLI ntn на момент выхода скилла доступен только на macOS и Linux (Windows — через WSL2). До 11 августа 2026 года Workers были бесплатными, после — тарифицируются кредитами Notion.
Практический пример: Worker с вебхуком на GitHub автоматически создаёт запись в базе релизов при каждом push в репозиторий — Hermes настраивает такой Worker, а дальше Notion обновляется уже без участия агента.
Частые ошибки при подключении и их решение
Notion возвращает 404 на существующую страницу. Страница не расшарена с интеграцией. Откройте меню ... → Connect to и добавьте интеграцию. Это самая распространённая ошибка, и она не связана с Hermes.
Агент не находит токен. Токен должен лежать в .env профиля Hermes как NOTION_API_KEY, а не передаваться в каждом сообщении. После изменения .env перезапустите сессию агента.
CLI просит логин через браузер. Установите NOTION_API_TOKEN (равным интеграционному токену) и NOTION_KEYRING=0 — тогда ntn работает без браузера, в том числе на сервере без графического окружения.
Слишком частые запросы. API Notion ограничивает примерно 3 запросами в секунду. Не просите агента обработать тысячу задач одним циклом — разбейте операцию на части.
Старые базы не находятся. В API версии 2025-09-03 базы данных называются data sources и имеют два идентификатора. Если пишете интеграцию сами — используйте database_id при создании записей и data_source_id при запросах.
FAQ
Нужен ли платный тариф Notion для подключения Hermes? Нет. Интеграция через API и скилл productivity-notion работает на бесплатном тарифе. Платный тариф (Business или Enterprise) нужен только для продвинутой функции Notion Workers.
Опасна ли интеграция для данных? Hermes работает с токеном интеграции и видит только те страницы и базы, которые вы расшарили с этой интеграцией. Остальное пространство для API невидимо. Токен хранится в .env и не должен попадать в чат или публичные файлы.
Может ли Hermes читать и анализировать мои заметки в Notion? Да. Агент читает страницы как Markdown и может составить саммари, выделить задачи или найти нужную информацию по запросу — например, «найди в заметках встреч все упоминания бюджета».
Чем интеграция Hermes отличается от обычного бота в Notion? Hermes живёт не внутри Notion, а на вашем компьютере или сервере: он работает с Notion по API, но при этом умеет читать почту, ходить в интернет, работать с другими сервисами и запускать задачи по расписанию. Поэтому он может не только писать в Notion, но и собирать для него данные из внешних источников.
Что делать, если агент не видит новую страницу? Проверьте, что страница создана в том разделе, который расшарен с интеграцией, и что запрос агента не содержит опечаток в названии. Поиск Notion ищет по названиям страниц — уточните запрос или дайте агенту прямую ссылку на страницу.