joplin-mcp-server — MCP-сервер для Claude Code: заметки Joplin агенту
Даёт агенту доступ к заметкам и блокнотам Joplin: поиск, чтение, создание и правка через REST API. Полезен, если держите базу знаний в Joplin.
claude mcp add --env JOPLIN_TOKEN=<JOPLIN_TOKEN> --env JOPLIN_HOST=<JOPLIN_HOST> --env JOPLIN_PORT=<JOPLIN_PORT> --env JOPLIN_PROFILE=<JOPLIN_PROFILE> --env JOPLIN_CLI=<JOPLIN_CLI> --transport stdio jordanburke-joplin-mcp-server -- npx -y joplin-mcp-serverЧто делает joplin-mcp-server
Сервер поднимает собственный экземпляр Joplin Terminal рядом с собой и отдаёт его возможности по MCP. Десктопное приложение не нужно, глобальных установок тоже. Если Joplin Desktop уже запущен, sidecar сам ищет свободный порт в диапазоне 41184-41193 и работает параллельно. Данные по умолчанию лежат в ~/.config/joplin-mcp, отдельно от десктопной установки.
Запуск простой: npx joplin-mcp-server --token your_joplin_token. Токен обязателен. Синхронизацию задают флагами --sync-target и --sync-path — поддерживаются filesystem, webdav, nextcloud, joplin-cloud, joplin-server, s3, dropbox и onedrive. Для filesystem путь понимает ~ и переменные окружения, а на WSL сервер сам подставляет путь Windows, если ~/ пуст. Хотите подключиться к уже работающему Joplin — выставьте JOPLIN_HOST или JOPLIN_PORT, и sidecar не запустится.
Без токена сервер не заработает, это первое, что стоит подготовить. Транспорт по умолчанию stdio, HTTP включается флагом --transport http с портом 3000.
Какие задачи решает
- найти заметку по фразе, не открывая Joplin
- создать заметку из ответа агента
- поправить текст в существующем блокноте
- синхронизировать заметки между машинами
- подключить агента к Joplin на другом хосте
Примеры запросов агенту
- Найди в Joplin заметки про деплой и покажи последнюю
- Создай заметку «Итоги недели» в блокноте Work
- Прочитай заметку про API и допиши в неё список задач
Как установить joplin-mcp-server
Командой платформы
claude mcp add --env JOPLIN_TOKEN=<JOPLIN_TOKEN> --env JOPLIN_HOST=<JOPLIN_HOST> --env JOPLIN_PORT=<JOPLIN_PORT> --env JOPLIN_PROFILE=<JOPLIN_PROFILE> --env JOPLIN_CLI=<JOPLIN_CLI> --transport stdio jordanburke-joplin-mcp-server -- npx -y joplin-mcp-serverВместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера
Командой платформы
codex mcp add jordanburke-joplin-mcp-server --env JOPLIN_TOKEN=<JOPLIN_TOKEN> --env JOPLIN_HOST=<JOPLIN_HOST> --env JOPLIN_PORT=<JOPLIN_PORT> --env JOPLIN_PROFILE=<JOPLIN_PROFILE> --env JOPLIN_CLI=<JOPLIN_CLI> -- npx -y joplin-mcp-serverВместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"jordanburke-joplin-mcp-server": {
"command": "npx",
"args": [
"-y",
"joplin-mcp-server"
],
"env": {
"JOPLIN_TOKEN": "<JOPLIN_TOKEN>",
"JOPLIN_HOST": "<JOPLIN_HOST>",
"JOPLIN_PORT": "<JOPLIN_PORT>",
"JOPLIN_PROFILE": "<JOPLIN_PROFILE>",
"JOPLIN_CLI": "<JOPLIN_CLI>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"jordanburke-joplin-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"joplin-mcp-server"
],
"env": {
"JOPLIN_TOKEN": "<JOPLIN_TOKEN>",
"JOPLIN_HOST": "<JOPLIN_HOST>",
"JOPLIN_PORT": "<JOPLIN_PORT>",
"JOPLIN_PROFILE": "<JOPLIN_PROFILE>",
"JOPLIN_CLI": "<JOPLIN_CLI>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e JOPLIN_TOKEN=<JOPLIN_TOKEN> -e JOPLIN_HOST=<JOPLIN_HOST> -e JOPLIN_PORT=<JOPLIN_PORT> -e JOPLIN_PROFILE=<JOPLIN_PROFILE> -e JOPLIN_CLI=<JOPLIN_CLI> jordanburke-joplin-mcp-server npx -y joplin-mcp-serverВместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о joplin-mcp-server
Как установить joplin-mcp-server в Claude Code?
Выполните claude mcp add joplin-mcp-server -e JOPLIN_TOKEN=<JOPLIN_TOKEN> -e JOPLIN_SYNC_PASSWORD=<JOPLIN_SYNC_PASSWORD> -- npx -y joplin-mcp-server. Токен Joplin обязателен.
Что делает joplin-mcp-server?
Поднимает Joplin Terminal как sidecar и открывает агенту поиск, чтение, создание и правку заметок и блокнотов через MCP.
Нужно ли ставить Joplin Desktop?
Нет. Сервер несёт Joplin CLI внутри себя. Если десктоп уже запущен, sidecar подберёт свободный порт и оба экземпляра продолжат синхронизацию.
