Joplin MCP Server

Joplin MCP Server

alondmntMIT
127 звёзд11 форков
Joplin MCP Server — это связующее звено между AI-ассистентами (Claude, Cline, Goose) и вашим приложением для заметок Joplin. Сервер использует протокол MCP и открывает базе заметок доступ к 26 инструментам для полного управления данными. Вместо того чтобы вручную искать заметки, создавать блокноты или прикреплять теги, вы просто формулируете задачу ассистенту. Он сам выполнит нужную операцию через Joplin API. Это экономит время и ускоряет работу с информацией. Сервер написан на Python с библиотекой FastMCP.
Подключить MCPОткрыть на GitHub
Подключение

Подключить Joplin MCP Server

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

Куда подключить

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Клиент запускает MCP-сервер как локальный процесс.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "joplin-mcp": {
      "command": "uvx",
      "args": [
        "joplin-mcp"
      ]
    }
  }
}

Сгенерировано из существующей команды запуска. Желательно сверить с README.

Инструкция собрана из данных карточки и пока не отмечена как проверенная редакцией. Сверьте команду с README источника и не передавайте лишние права или секреты.

Как оценить Joplin MCP Server

Joplin MCP Server относится к MCP-инструментам. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

Происхождение
Проект сообщества
Лицензия
MIT
Реализация
Python
Транспорт
stdio

Что проверить перед выбором

  • Изучите README, открытые issues и историю последних изменений в репозитории.
  • Проверьте команду установки и зависимости перед запуском в рабочем окружении.
  • Ограничьте доступ MCP-сервера только нужными файлами, API и переменными окружения.

Карточка отредактирована 20.07.2026.

Автоматическая проверка источника ещё не выполнена. Внешних источников в карточке: 1.

Характеристики

Общее

  • СтатусСообщество
  • Разработчикalondmnt
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Поиск заметок по тексту, названию блокнота или тегу, включая поиск среди удалённых записей (корзина).
  • Полный набор операций с заметками: создание, чтение, обновление, удаление.
  • Извлечение и чтение текста из изображений и PDF-файлов, прикреплённых к заметкам (OCR).
  • Управление блокнотами: создание, переименование, удаление.
  • Гибкая работа с тегами: создание, удаление, привязка к заметкам и отвязка, поиск по тегу.
  • Восстановление случайно удалённых заметок и блокнотов из корзины в один клик.
  • Импорт файлов в новые заметки: Markdown, HTML, CSV, TXT, а также экспортных файлов JEX.
  • Просмотр внутренних ссылок между заметками.
  • Проверка связи с Joplin (команда ping).

Как подключить

Для работы нужен Joplin Desktop с включённым Web Clipper. Откройте Инструменты → Параметры → Web Clipper, включите сервис и скопируйте токен авторизации.

Установите сервер через пакетный менеджер:

pip install joplin-mcp

или запустите без установки через uvx (рекомендуется):

uvx --from joplin-mcp joplin-mcp-install

После установки настройте MCP-клиента. Вот пример для Claude Desktop (файл claude_desktop_config.json):

{ "mcpServers": { "joplin": { "command": "uvx", "args": ["joplin-mcp"], "env": { "JOPLIN_TOKEN": "ваш_токен_здесь" } } } }

Перезапустите клиент. Теперь ассистент видит вашу библиотеку Joplin.

Примеры запросов

  • «Найди все заметки из блокнота «Проекты» с тегом «архив» и перемести их в блокнот «Архив 2024»».
  • «Создай новую заметку в блокноте «Идеи» с заголовком «Запуск блога» и содержимым из файла blog_launch.md».
  • «Обнови заметку «Meeting Notes 2025-03-15»: добавь в конец строку «Action: купить домен» и смени тег на «срочно»».
  • «Восстанови из корзины удалённую заметку и добавь к ней тег «на проверку»».

Технические детали

  • Язык: Python
  • Транспорт: stdio
  • Лицензия: MIT
  • Разработчик: alondmnt
  • Количество инструментов: 26
  • Совместимость: Claude Desktop, Claude Code, Cline, Goose, любые MCP-клиенты
  • Зависимости: Joplin Desktop, включённый Web Clipper

Поделиться