Joplin MCP
MCP-сервер заметок Joplin: ассистент ищет, создает, правит, помечает тегами и восстанавливает заметки из корзины.
- 174 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- При включенных разрешениях агент создает, правит и удаляет заметки, блокноты и теги.
- Удаление необратимо, если выбрано разрешение Delete.
Установка
- Работает в
В терминале, через 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-сервер для Apple Notes на Mac: агент читает, ищет, создает, правит и выгружает заметки, управляет папками и тегами.
Simplenote MCP — заметки Simplenote в агенте
simplenote-mcp
Официальный MCP-сервер Simplenote от Automattic: агент читает, ищет и по желанию правит заметки, на macOS работает без входа
Obsidian MCP Server
obsidian-mcp-server
MCP-сервер для хранилища Obsidian: чтение, поиск и точечная правка заметок, разделов, frontmatter и тегов
Официальный MCP-сервер Kibela ищет, читает и правит заметки, папки и комментарии вашей вики прямо из чата с ассистентом
Локальный MCP-сервер для безопасного чтения, поиска и правки заметок в хранилище Obsidian, доступ ограничен корнем хранилища
Коротко о README
README перечисляет 26 инструментов по группам, быстрый старт через Web Clipper, установку для Claude Desktop, Claude Code, Jan AI и OllMCP, уровни разрешений, список разрешенных блокнотов с шаблонами, Docker и справочник инструментов.