MCP server for Obsidian

Что умеет сервер

Это проект сообщества (репозиторий MarkusPfundstein), а не продукт команды Obsidian, и работает он через плагин сообщества Local REST API для Obsidian. Сервер предоставляет семь инструментов: список файлов в корне хранилища и в указанной папке, чтение содержимого заметки, поиск текста по всему хранилищу, вставка текста в существующую заметку относительно заголовка, блока или поля фронтматтера, добавление текста в новый или существующий файл и удаление файла или каталога.

Когда использовать

Подключайте сервер, если ваши рабочие заметки живут в Obsidian и вы хотите, чтобы ассистент работал с ними напрямую: подвести итог последней встречи, найти все заметки, где упоминается нужная технология, и объяснить контекст, или оформить конспект в новую заметку. В README советуют сначала попросить Claude использовать Obsidian, тогда он будет стабильно вызывать инструменты.

Ограничения и безопасность

Для работы Obsidian должен быть запущен вместе с установленным и включённым плагином Local REST API, а ключ API берётся из настроек плагина. Хост по умолчанию 127.0.0.1, порт 27124. Требуется Python 3.11 или новее. Сервер закреплён на версиях Python SDK mcp от 1.1.0 до 2.0 (не включая): с mcp 2.0 он падает при импорте.

Агент получает доступ на чтение и запись к хранилищу, включая удаление файлов и каталогов, поэтому подключайте его к vault с резервной копией или под контролем версий. API-ключ передаётся через переменные окружения в конфигурации клиента, не храните его в общедоступных репозиториях.

Сначала установите и включите в Obsidian плагин Local REST API и скопируйте ключ API из его настроек. По умолчанию хост 127.0.0.1, порт 27124.

Claude Desktop

Файл конфигурации: в macOS ~/Library/Application\ Support/Claude/claude_desktop_config.json, в Windows %APPDATA%/Claude/claude_desktop_config.json. Добавьте:

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<YOUR_OBSIDIAN_API_KEY>",
        "OBSIDIAN_HOST": "<your_obsidian_host>",
        "OBSIDIAN_PORT": "<your_obsidian_port>"
      }
    }
  }
}

Если Claude не находит uv или uvx, выполните which uvx и впишите полный путь в command.

Docker

Скопируйте .env.example в .env и укажите ключ API:

cp .env.example .env
docker compose build

Подключите контейнер в конфигурации клиента (используйте docker compose run --rm -T, а не docker compose up):

{
  "mcpServers": {
    "mcp-obsidian": {
      "command": "docker",
      "args": [
        "compose",
        "-f",
        "<dir_to>/mcp-obsidian/docker-compose.yml",
        "run",
        "--rm",
        "-T",
        "mcp-obsidian"
      ]
    }
  }
}