Joplin MCP Server
Joplin MCP Server открывает ИИ-ассистенту ваши заметки: поиск, чтение, создание, правка, удаление и импорт файлов Markdown.
- 96 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Ассистент читает, меняет и удаляет заметки, а токен лежит в `.env` открытым текстом.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/joplin-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Ассистент читает, меняет и удаляет заметки, а токен лежит в `.env` открытым текстом.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP-сервер подключается к Joplin Desktop через Web Clipper Service и дает ассистенту восемь инструментов: `search_notes`, `get_note`, `list_notebooks`, `create_notebook`, `create_note`, `update_note`, `delete_note` и `import_markdown`. Блокноты можно создавать вложенными и указывать по пути вроде `Work/Projects`. Заметки пишутся в Markdown, помечаются как задачи. Удаление отправляет заметку в корзину, а при параметре `permanent` стирает насовсем. Доступ идет по токену API из настроек Web Clipper. Токен кладется в файл `.env` как `JOPLIN_TOKEN`.
Для кого. Пользователям Joplin, которые ведут заметки в Markdown и хотят искать в них и дополнять их голосом ассистента.
Подходит, если
- В блокноте накопились сотни заметок, и нужен ответ на вопрос по ним без ручного поиска
- Протокол встречи надо сохранить в блокнот `Work/Projects` одной командой
- Готовый файл Markdown требуется загрузить в Joplin как новую заметку
- Список дел ведется в заметках, и ассистент должен отмечать задачи
Не подходит, если
- Ассистенту нельзя доверять удаление: инструмент `delete_note` умеет стирать заметки насовсем
- Joplin Desktop не запущен: сервер говорит с приложением через локальный Web Clipper
- Нужна смысловая выборка по тексту: в README описан только полнотекстовый поиск
Пример запроса к агенту
Найди в Joplin заметки про релиз 2.0 и создай в блокноте `Work/Projects` заметку со списком открытых задач.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
JOPLIN_TOKENобязательная, секрет- Токен API из настроек Web Clipper в Joplin Desktop.
Ограничения
Нужны Python 3.10 или новее, `uv` и запущенный Joplin Desktop с включенным Web Clipper Service. Токен хранится открытым текстом в `.env`. Ассистент получает право создавать, менять и удалять заметки, включая безвозвратное удаление. В README описана настройка только для Claude Desktop, пути в примере нужно заменить своими. Последний коммит сделан в августе 2026. Перед первым запуском сделайте экспорт заметок из Joplin.
Как отключить. Удалите блок `joplin` из `claude_desktop_config.json` и перезапустите Claude Desktop. Выключите Web Clipper Service в Joplin, токен удалите из `.env`.
Частые вопросы
Где взять токен для Joplin MCP Server?
Откройте Joplin Desktop, затем Tools, Options, Web Clipper, включите сервис и скопируйте токен API. Вставьте его в `.env` как `JOPLIN_TOKEN`.
Удаляет ли `delete_note` заметки насовсем?
По умолчанию нет, заметка уходит в корзину. Насовсем она стирается только с параметром `permanent`.
Можно ли загрузить файл Markdown в Joplin?
Да, инструмент `import_markdown` принимает `file_path` и создает из файла новую заметку, при желании в блокноте `notebook_name`.
Работает ли сервер без запущенного Joplin?
Нет, он обращается к Web Clipper Service внутри Joplin Desktop, поэтому приложение должно быть запущено.
Как указать блокнот при создании заметки?
Передайте `notebook_name` с названием или путем вроде `Work/Projects`, либо `parent_id` с идентификатором блокнота.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер заметок Joplin: ассистент ищет, создает, правит, помечает тегами и восстанавливает заметки из корзины.
MCP-сервер для Apple Notes на Mac: агент читает, ищет, создает, правит и выгружает заметки, управляет папками и тегами.
Simplenote MCP — заметки Simplenote в агенте
simplenote-mcp
Официальный MCP-сервер Simplenote от Automattic: агент читает, ищет и по желанию правит заметки, на macOS работает без входа
Официальный MCP-сервер Kibela ищет, читает и правит заметки, папки и комментарии вашей вики прямо из чата с ассистентом
Obsidian Sync MCP — хранилище Obsidian для агента
Obsidian Sync MCP
MCP-сервер дает агенту читать и править заметки Obsidian из папки или через Self-hosted LiveSync, даже когда ноутбук выключен
MCP-сервер на Rust для папки с заметками в Markdown: агент ищет, читает заметки, видит обратные ссылки, теги, задачи и историю версий
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Joplin MCP Server (эта карточка) | нет | API-ключ | 96 | |
| mcp-obsidian | нет | API-ключ | 4 533 | работает с хранилищем Obsidian; Joplin MCP Server подключается к Joplin через Web Clipper |
| mcp-logseq — MCP-сервер для Logseq | нет | API-ключ | 351 | дает доступ к графу Logseq; этот сервер ведет блокноты и заметки Joplin |
Коротко о README
Сервер на Python использует API Joplin и MCP по stdio. Для отладки есть режим `MCP_LOG_LEVEL=debug mcp dev`, который открывает MCP Inspector в браузере.