Joplin MCP Server

Joplin MCP Server

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

Установка

uvx joplin-mcp

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

Общее

  • СтатусСообщество
  • Разработчик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

Поделиться