Joplin MCP

MCP-сервер заметок Joplin: ассистент ищет, создает, правит, помечает тегами и восстанавливает заметки из корзины.

  • 174 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • При включенных разрешениях агент создает, правит и удаляет заметки, блокноты и теги.
  • Удаление необратимо, если выбрано разрешение Delete.
Все причины и проверки

alondmnt/joplin-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/joplin-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • При включенных разрешениях агент создает, правит и удаляет заметки, блокноты и теги.
  • Удаление необратимо, если выбрано разрешение Delete.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Joplin MCP — сервер на FastMCP, который работает с Joplin через его API (библиотека joppy). 26 инструментов охватывают заметки (`find_notes`, `get_note`, `create_note`, `update_note`, `edit_note`, `delete_note`, чтение текста распознавания с вложенных картинок и PDF через `get_note_resources`, ссылки через `get_links`), блокноты, теги, корзину (`restore_from_trash`) и импорт файлов Markdown, HTML, CSV, TXT и JEX. Уровни разрешений задаются при установке: чтение включено всегда, создание, изменение и удаление включаются по желанию. Список разрешенных блокнотов (gitignore-шаблоны, например `Work` или `Projects/**`, отрицания `!Projects/Secret`) скрывает остальные блокноты от агента и блокирует запись в них. Для Claude Code есть плагин с навыком `/joplin`, который подсказывает, когда править заметку, а когда обновлять, как читать длинные заметки и массово расставлять теги.

Для кого. Пользователям Joplin, которые хотят искать по своим заметкам и вести их с помощью Claude Desktop, Claude Code, Jan AI или локальных моделей Ollama.

Подходит, если

  • Найти все заметки о теме и свести их в одну сводку.
  • Создать заметку для встречи на сегодня и сразу расставить теги.
  • Разобрать прикрепленный PDF: прочитать распознанный текст вложения.
  • Ограничить агента блокнотами Work и Projects, оставив личные скрытыми.

Не подходит, если

  • Нужно синхронизировать заметки Joplin между устройствами: за это отвечает сам Joplin.
  • Агенту нельзя доверять удаление: оставьте разрешения только на чтение.
  • Приложение Joplin закрыто: сервер работает через его Web Clipper, он должен быть включен.

Пример запроса к агенту

Найди в Joplin заметки про планирование релиза, свяжи их тегом release и покажи список с краткими выжимками.

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

JOPLIN_TOKEN обязательная, секрет
Токен авторизации Web Clipper из Joplin Desktop
JOPLIN_NOTEBOOK_ALLOWLIST
Разрешенные блокноты через запятую, шаблоны gitignore

Ограничения

Для связи нужен включенный Web Clipper в Joplin Desktop (Tools, Options, Web Clipper) и его токен авторизации в `JOPLIN_TOKEN`. Установщик `joplin-mcp-install` настраивает Claude Desktop и Jan AI автоматически. Удаление необратимо, если включено разрешение Delete. При списке разрешенных блокнотов создание блокнота верхнего уровня и перенос на верхний уровень блокируются, чтобы агент не вывел блокнот из защищенной области. Последний коммит: сентябрь 2026.

Как отключить. Удалите запись joplin из конфигурации клиента и выключите Web Clipper в настройках Joplin, чтобы закрыть доступ по токену.

Частые вопросы

Где взять токен Joplin?

В Joplin Desktop откройте Tools, Options, Web Clipper, включите службу и скопируйте токен авторизации.

Как поставить в Claude Code?

Командами `/plugin marketplace add alondmnt/joplin-mcp` и `/plugin install joplin-mcp`, токен спросят при первом использовании.

Можно ли запретить удаление?

Да, при установке выбирают уровни Read, Write, Update и Delete, чтение включено всегда.

Как ограничить блокноты?

Списком `notebook_allowlist` в `joplin-mcp.json` или переменной `JOPLIN_NOTEBOOK_ALLOWLIST`, шаблоны в стиле gitignore.

Работает ли сервер в Docker?

Да, в README есть раздел Docker, настройка токена такая же.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

Joplin MCP Server открывает ИИ-ассистенту ваши заметки: поиск, чтение, создание, правка, удаление и импорт файлов Markdown.

MCP-серверРасширенный доступ96Звезды репозитория

MCP-сервер для Apple Notes на Mac: агент читает, ищет, создает, правит и выгружает заметки, управляет папками и тегами.

MCP-серверШирокий доступ187Звезды репозитория
Официальный

Официальный MCP-сервер Simplenote от Automattic: агент читает, ищет и по желанию правит заметки, на macOS работает без входа

MCP-серверРасширенный доступ33Звезды репозитория

Obsidian MCP Server

obsidian-mcp-server

MCP-сервер для хранилища Obsidian: чтение, поиск и точечная правка заметок, разделов, frontmatter и тегов

MCP-серверРасширенный доступ705Звезды репозитория
Официальный

Официальный MCP-сервер Kibela ищет, читает и правит заметки, папки и комментарии вашей вики прямо из чата с ассистентом

MCP-серверРасширенный доступ16Звезды репозитория

Локальный MCP-сервер для безопасного чтения, поиска и правки заметок в хранилище Obsidian, доступ ограничен корнем хранилища

MCP-серверРасширенный доступ1,7 тыс.Звезды репозитория

Коротко о README

README перечисляет 26 инструментов по группам, быстрый старт через Web Clipper, установку для Claude Desktop, Claude Code, Jan AI и OllMCP, уровни разрешений, список разрешенных блокнотов с шаблонами, Docker и справочник инструментов.

Бейдж для README

Сообщить о проблеме