TriliumNext MCP Server
MCP-сервер к заметкам TriliumNext через ETAPI: 20 инструментов для чтения, записи, поиска, вложений, ревизий и бэкапов
- 71 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Токен ETAPI дает ассистенту чтение, правку и удаление всех заметок, а действия `backup`, `export` и `import` работают с базой целиком
- В режиме stdio вложения читаются из локальных путей, в режиме HTTP без токена шлюза сервер открыт всем, кто до него дотянется
Установка
- Работает в
Ручная установка
claude mcp add trilium node /path/to/triliumnext-mcp/dist/index.js --scope user -e TRILIUM_TOKEN=<your_etapi_token> -e TRILIUM_URL=<your_trilium_url>/etapiСначала git clone, npm install, npm run build. Токен ETAPI создается в TriliumNext.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Токен ETAPI дает ассистенту чтение, правку и удаление всех заметок, а действия `backup`, `export` и `import` работают с базой целиком
- В режиме stdio вложения читаются из локальных путей, в режиме HTTP без токена шлюза сервер открыт всем, кто до него дотянется
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
TriliumNext MCP Server подключает ИИ-ассистента к вашему экземпляру TriliumNext через ETAPI, его программный интерфейс. Двадцать инструментов разбиты на восемь групп: заметки, поиск, организация дерева, атрибуты и метки, журнал и календарь, вложения, ревизии, системные операции. Ассистент читает заметку вместе с хлебными крошками и обратными ссылками, создает и правит ее в четырех режимах (метаданные, замена, дописывание, правка по поиску или `diff`) и пишет в Markdown, а сервер сохраняет HTML. Картинки и файлы вкладываются в заметку тем же вызовом, из base64, `data`: URL, локального пути или адреса. Ссылки вида `note:abc123` сервер превращает в настоящие ссылки Trilium и отклоняет те, что ведут на несуществующую заметку. Поиск, если нашлось ноль заметок, сам повторяет запрос как ИЛИ по отдельным словам и показывает, какое слово ничего не дало. Перед откатом ревизии сервер делает снимок текущего состояния, поэтому откат обратим. Кроме stdio, сервер работает по HTTP/SSE и StreamableHTTP. В многопользовательском режиме каждый клиент приносит свой адрес Trilium и токен ETAPI, а доступ к шлюзу закрывается токеном, JWT или OIDC. Есть ограничение частоты запросов и метрики для Prometheus.
Для кого. Пользователям TriliumNext, которые ведут заметки и базу знаний в Trilium и хотят поручить агенту чтение, поиск и правку, и командам, которые поднимают один сервер на многих пользователей.
Подходит, если
- Агенту нужно найти заметки по теме и пересказать их, а в запросе есть слово с опечаткой, из-за которого Trilium ничего не вернул
- В заметку нужно дописать итоги встречи и вложить скриншоты из локальной папки одним вызовом
- Заметку правят по частям: поиском и заменой или `unified diff`, без перезаписи всего текста
- Правка пошла не туда, и заметку нужно откатить к ревизии, сохранив текущее состояние
- Один сервер поднимают в Docker для нескольких человек, и у каждого свой токен ETAPI
Не подходит, если
- Вы пользуетесь Obsidian или Joplin: сервер работает только с TriliumNext, для них есть отдельные серверы
- Нужна офлайн-работа без запущенного Trilium: каждый вызов идет через ETAPI работающего экземпляра
- Сервер откроют наружу без токена шлюза: заметки и функции бэкапа и импорта окажутся доступны всем
- Агенту нельзя доверять удаление: инструмент delete_note и действия `unlink` и `import` меняют дерево заметок
Пример запроса к агенту
Найди в Trilium заметки про релиз 2.0, дополни итоговую заметку списком решений встречи и вложи скриншот ~/Desktop/board.pngMCP
- Транспорт
- stdio, http, sse
- Авторизация
- API-ключ
Переменные окружения
TRILIUM_TOKENобязательная, секрет- Токен ETAPI из настроек TriliumNext
TRILIUM_URLобязательная- Адрес ETAPI, по умолчанию http://localhost:37740/etapi
Ограничения
- Нужен работающий TriliumNext с включенным ETAPI и токеном. Адрес по умолчанию: http://localhost:37740/etapi.
- Установка из исходников: git clone, npm install и npm run build. Готового пакета на npm в инструкции нет.
- Поиск ищет по заголовкам и атрибутам: заметка, найденная только по тексту, возвращается, но получает нулевую оценку и встает в конец выдачи.
- Лимит тела запроса по SSE по умолчанию 500 МБ.
- Лицензия MIT указана в README, отдельного файла LICENSE в репозитории нет.
- В режиме stdio чтение локальных файлов для вложений включено по умолчанию, в режиме HTTP выключено.
Как отключить. Командой `claude mcp remove trilium` убирается запись из Claude Code. Токен ETAPI можно отозвать в самом TriliumNext, после этого сервер перестанет проходить авторизацию. Папку со сборкой удаляют вручную.
Частые вопросы
Как получить токен ETAPI для сервера?
Токен создают в самом TriliumNext: Options, раздел ETAPI, новый токен. Его передают переменной TRILIUM_TOKEN или параметром --token.
Как подключить сервер к Claude Code?
Выполните `claude mcp add trilium node` /путь/к/dist/index.js --scope user с переменными TRILIUM_TOKEN и TRILIUM_URL. Сервер появится во всех репозиториях.
Почему поиск вернул заметки, хотя в запросе была опечатка?
Если запрос из двух и более слов дал ноль результатов, сервер повторяет его как ИЛИ по отдельным словам. В ответе есть счетчик, какое слово не нашлось ни в одном заголовке и атрибуте.
Можно ли откатить неудачную правку?
Да. Инструмент restore_revision возвращает заметку к выбранной ревизии и перед этим сохраняет снимок текущего состояния, поэтому сам откат тоже можно отменить.
Можно ли подключить одним сервером нескольких человек?
Да, в многопользовательском режиме каждый клиент передает свой адрес Trilium и токен ETAPI. Доступ к шлюзу защищается общим токеном или JWT и OIDC, есть Docker Compose-файл для развертывания.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный MCP-сервер Kibela ищет, читает и правит заметки, папки и комментарии вашей вики прямо из чата с ассистентом
tracker-mcp
traker-mcp
MCP-сервер Яндекс Трекера с 187 инструментами и скиллом: задачи, очереди, доски, спринты и автоматизация через API v3, режим только чтения
MCP-сервер Trello на 57 инструментов: карточки, списки, чек-листы, вложения, комментарии, поля и рабочие пространства, плюс выгрузка критериев приемки
Notion MCP (awkoy)
Notion MCP Server (awkoy)
Notion MCP на токене: агент ищет страницы, ведет базы, правит блоки и комментарии через три инструмента и 47 операций, без ручного входа
MCP-сервер noteriv-mcp открывает агенту хранилище Noteriv: чтение, запись, поиск, теги, обратные ссылки, ежедневные заметки.
Подключает агента к Nextcloud: заметки, календарь, контакты, файлы, почта и доски Deck через 110 с лишним инструментов MCP
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| TriliumNext MCP Server (эта карточка) | нет | API-ключ | 71 | |
| Joplin MCP | нет | API-ключ | 174 | заметки Joplin: другое приложение со своим API |
| Obsidian MCP | нет | не нужна | 751 | хранилище Obsidian из файлов Markdown, у Trilium своя база и ETAPI |
Коротко о README
README начинается с оглавления и списка возможностей: 20 инструментов, ссылки между заметками, восстановление ревизий и три транспорта. Дальше идут установка, настройка через аргументы, переменные окружения и файл, журналы и метрики. Таблицы описывают каждый инструмент по группам, отдельные разделы объясняют вложение картинок и файлов, а большой блок посвящен многопользовательскому развертыванию с аутентификацией шлюза.