Joplin MCP Server — MCP-сервер для Claude Code: функции и установка
Даёт ИИ-ассистенту доступ к заметкам Joplin: он может искать их, менять теги и импортировать файлы. Для подключения понадобится токен Joplin.
claude mcp add --env JOPLIN_TOKEN=<JOPLIN_TOKEN> --env JOPLIN_URL=<JOPLIN_URL> --transport stdio joplin-mcp-server -- uvx joplin-mcpЧто делает Joplin MCP Server
Сервер связывает Joplin с ИИ-ассистентом через MCP. С его помощью можно искать заметки, просматривать блокноты и теги, создавать и редактировать записи, а также восстанавливать заметки из корзины. Для вложенных изображений и PDF доступен текст распознавания OCR.
Сервер умеет импортировать Markdown, HTML, CSV, TXT и JEX-файлы, а также каталоги. Доступ можно ограничить списком блокнотов: правила учитывают вложенные пути и исключения. Разрешения на чтение, запись, изменение и удаление настраиваются отдельно. Без включённой службы Web Clipper в Joplin и её API-токена подключение не настроить.
Какие задачи решает
- найти заметки по теме или тегу
- создать запись и разложить её по блокнотам
- пометить заметки тегами
- импортировать Markdown или CSV в Joplin
- ограничить доступ ассистента выбранными блокнотами
Примеры запросов агенту
- Найди в Joplin заметки о Python и покажи подходящие.
- Создай заметку о сегодняшней встрече в блокноте Work.
- Импортируй файл
notes.mdв Joplin и присвой новой заметке тег «важное».
Как установить Joplin MCP Server
Командой платформы
claude mcp add --env JOPLIN_TOKEN=<JOPLIN_TOKEN> --env JOPLIN_URL=<JOPLIN_URL> --transport stdio joplin-mcp-server -- uvx joplin-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from joplin-mcp <команда>
Командой платформы
codex mcp add joplin-mcp-server --env JOPLIN_TOKEN=<JOPLIN_TOKEN> --env JOPLIN_URL=<JOPLIN_URL> -- uvx joplin-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from joplin-mcp <команда>
Файл настроек
{
"mcpServers": {
"joplin-mcp-server": {
"command": "uvx",
"args": [
"joplin-mcp"
],
"env": {
"JOPLIN_TOKEN": "<JOPLIN_TOKEN>",
"JOPLIN_URL": "<JOPLIN_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from joplin-mcp <команда>
Файл настроек
{
"servers": {
"joplin-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"joplin-mcp"
],
"env": {
"JOPLIN_TOKEN": "<JOPLIN_TOKEN>",
"JOPLIN_URL": "<JOPLIN_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from joplin-mcp <команда>
Командой платформы
gemini mcp add -e JOPLIN_TOKEN=<JOPLIN_TOKEN> -e JOPLIN_URL=<JOPLIN_URL> joplin-mcp-server uvx joplin-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from joplin-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Joplin MCP Server
Как установить Joplin MCP Server в Claude Code?
Выполните claude mcp add joplin-mcp -e JOPLIN_TOKEN=<JOPLIN_TOKEN> -- uvx joplin-mcp. Перед этим включите службу Web Clipper в настройках Joplin и скопируйте API-токен.
Что делает Joplin MCP Server?
Подключает заметки, блокноты и теги Joplin к ИИ-ассистенту. Ассистент может искать и редактировать записи, импортировать файлы и управлять тегами.
Можно ли закрыть ассистенту доступ к части блокнотов?
Да. Список разрешённых блокнотов задаётся через notebook_allowlist или переменную JOPLIN_NOTEBOOK_ALLOWLIST; можно включать вложенные пути и исключать отдельные.
