Obsidian MCP

MarkusPfundstein/mcp-obsidian· Проверено 12.11.2026· 4,5 тыс.на GitHub

Даёт агенту доступ к хранилищу Obsidian: искать по заметкам, читать их, дописывать текст под нужный заголовок и создавать новые. Оба варианта работают через плагин Local REST API.

2 реализации:

Отдельный сервер на Python: обращается к REST API плагина и даёт 7 простых инструментов.

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

Что сделать до подключения

Плагин сообщества Local REST API (coddingtonbear/obsidian-local-rest-api): установите и включите его в настройках Obsidian, Obsidian должен быть запущен

uv; если клиент не находит uvx, укажите полный путь из which uvx

Python 3.11 или новее

OBSIDIAN_API_KEY

ключ из настроек плагина: Settings → Local REST API; хост по умолчанию 127.0.0.1, порт 27124

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'OBSIDIAN_API_KEY=<ключ Local REST API>' --env OBSIDIAN_HOST=127.0.0.1 --env OBSIDIAN_PORT=27124 --transport stdio obsidian \
  -- uvx mcp-obsidian

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.obsidian]
command = "uvx"
args = ["mcp-obsidian"]

[mcp_servers.obsidian.env]
OBSIDIAN_API_KEY = "<ключ Local REST API>"
OBSIDIAN_HOST = "127.0.0.1"
OBSIDIAN_PORT = "27124"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "<ключ Local REST API>",
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27124"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "obsidian": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "<ключ Local REST API>",
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27124"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "<ключ Local REST API>",
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27124"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "<ключ Local REST API>",
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27124"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "obsidian": {
        "type": "local",
        "command": ["uvx", "mcp-obsidian"],
        "environment": {
          "OBSIDIAN_API_KEY": "<ключ Local REST API>",
          "OBSIDIAN_HOST": "127.0.0.1",
          "OBSIDIAN_PORT": "27124"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "<ключ Local REST API>",
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27124"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": ["mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "<ключ Local REST API>",
        "OBSIDIAN_HOST": "127.0.0.1",
        "OBSIDIAN_PORT": "27124"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

list_files_in_vaultпоказывает файлы в корне хранилища

list_files_in_dirпоказывает файлы в папке

get_file_contentsчитает заметку

searchищет текст по всем заметкам

patch_contentвставляет текст под заголовок или в frontmatter

append_contentдописывает в новую или старую заметку

delete_fileудаляет файл или папку

MCP-сервер внутри самого плагина: отдельный сервер не нужен, видит активную заметку, теги и команды Obsidian.

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

Что сделать до подключения

Плагин Local REST API, установленный и включённый в Obsidian; Obsidian должен быть запущен

Клиент должен доверять локальному сертификату плагина (скачивается с https://127.0.0.1:27124/obsidian-local-rest-api.crt) или подключаться по http://127.0.0.1:27123/mcp/ после включения Settings → Local REST API → Enable HTTP server

Authorization

ключ из Settings → Local REST API, передаётся как Bearer-токен

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http obsidian-local-rest-api https://127.0.0.1:27124/mcp/ \
  --header 'Authorization: Bearer <ключ Local REST API>'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.obsidian-local-rest-api]
url = "https://127.0.0.1:27124/mcp/"
http_headers = { "Authorization" = "Bearer <ключ Local REST API>" }

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "obsidian-local-rest-api": {
      "url": "https://127.0.0.1:27124/mcp/",
      "headers": {
        "Authorization": "Bearer <ключ Local REST API>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "obsidian-local-rest-api": {
      "type": "http",
      "url": "https://127.0.0.1:27124/mcp/",
      "headers": {
        "Authorization": "Bearer <ключ Local REST API>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "obsidian-local-rest-api": {
      "httpUrl": "https://127.0.0.1:27124/mcp/",
      "headers": {
        "Authorization": "Bearer <ключ Local REST API>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "obsidian-local-rest-api": {
      "httpUrl": "https://127.0.0.1:27124/mcp/",
      "headers": {
        "Authorization": "Bearer <ключ Local REST API>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "obsidian-local-rest-api": {
        "type": "remote",
        "url": "https://127.0.0.1:27124/mcp/",
        "headers": {
          "Authorization": "Bearer <ключ Local REST API>"
        }
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://127.0.0.1:27124/mcp/
Request headers: Authorization: Bearer <ключ Local REST API>

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "obsidian-local-rest-api": {
      "url": "https://127.0.0.1:27124/mcp/",
      "headers": {
        "Authorization": "Bearer <ключ Local REST API>"
      }
    }
  }
}

Инструменты сервера

vault_listпоказывает файлы и папки

vault_readчитает заметку с frontmatter и тегами

vault_read_binaryчитает вложение, например картинку

vault_writeсоздаёт или перезаписывает заметку

vault_appendдописывает в конец

vault_patchправит раздел, блок или поле frontmatter

vault_deleteудаляет в корзину

vault_moveпереносит или переименовывает

vault_copyкопирует файл

vault_get_document_mapпоказывает заголовки и блоки заметки

active_file_get_pathпоказывает открытую заметку

search_simpleищет по тексту

search_queryищет по метаданным через JsonLogic

tag_listпоказывает теги с частотой

command_listпоказывает команды Obsidian

command_executeвыполняет команду Obsidian

open_fileоткрывает заметку в Obsidian

Показано 17 из 20.

Что попросить агента

«Открой последнюю заметку со звонка по архитектуре и перескажи её»Агент найдёт заметку через search или list_files_in_dir и прочитает её get_file_contents

«Найди все заметки, где упоминается <тема>, и коротко объясни, в каком контексте»Агент вызовет search по всему хранилищу и прочитает найденное через get_file_contents

«Сделай сводку последних заметок со встреч и сохрани её в новую заметку «<имя>.md» с вступлением для письма»Агент прочитает заметки get_file_contents и запишет сводку append_content в новый файл

«Допиши пункт «<текст>» в раздел «<заголовок>» заметки <имя>»Агент вызовет patch_content с привязкой к заголовку, во встроенном MCP плагина — vault_patch

«Найди заметки с тегом <тег>, где в frontmatter <поле> равно <значение>»Во встроенном MCP плагина агент вызовет tag_list и search_query с условием JsonLogic

Для каких задач

Найти все заметки, где упоминается тема, и объяснить контекст

Сделать сводку последних заметок со встреч и сохранить её новой заметкой

Дописать пункт в раздел заметки под нужным заголовком, не трогая остальное

Найти заметки по тегам и полям frontmatter

Запустить команду Obsidian так, будто вы выбрали её в палитре

Ограничения

Без запущенного Obsidian с включённым плагином Local REST API ни один вариант не работает

Плагин использует свой локальный сертификат: клиенту нужно ему доверять или переходить на HTTP-порт 27123

Папка конфигурации .obsidian закрыта для чтения и записи по умолчанию

У mcp-obsidian нет поиска по метаданным, тегов и команд Obsidian: это есть только во встроенном MCP плагина

Если не работает

mcp-obsidian падает при запуске с AttributeError: 'Server' object has no attribute 'list_tools'

Установился пакет mcp версии 2.0 или новее. Сервер работает только с mcp от 1.1.0 до 2.0: ставьте его с ограничением версии из pyproject.toml.

Клиент не подключается к https://127.0.0.1:27124/mcp/ из-за сертификата

Скачайте корневой сертификат плагина по адресу https://127.0.0.1:27124/obsidian-local-rest-api.crt и добавьте в доверенные. Другой путь: включите Enable HTTP server и подключайтесь к http://127.0.0.1:27123/mcp/.

Плагин отвечает 429 с кодом 42901

После 10 неверных ключей за минуту плагин временно отклоняет запросы. Подождите минуту и проверьте ключ в Settings → Local REST API.

Чтение файла из папки .obsidian возвращает 403 с кодом 40321

Папка конфигурации Obsidian закрыта для API и MCP на чтение и запись, это задано в плагине.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
mcp-obsidian	Markus Pfundstein	4,5 тыс.	локально	токен	7	31 августа 2026
Local REST API: встроенный MCP	coddingtonbear	3,1 тыс.	HTTP	токен	20	17 октября 2026

Частые вопросы

Какой вариант выбрать?

Встроенный MCP плагина не требует отдельного сервера и видит активную заметку, теги и команды. mcp-obsidian подойдёт клиентам без поддержки HTTP-серверов: он запускается как обычная команда через uvx.

Где взять ключ API?

Включите плагин Local REST API и откройте Settings → Local REST API: там ключ и сертификат.

Как подключить встроенный MCP к Claude Desktop?

Claude Desktop не умеет подключаться к HTTP-серверам напрямую. Используйте мост npx mcp-remote@latest https://127.0.0.1:27124/mcp/ --header "Authorization: Bearer <ключ>"; для него нужен Node.js.

Удалённые заметки пропадают насовсем?

Во встроенном MCP vault_delete по умолчанию переносит файл в корзину.

Работает ли сервер из России?

Плагин и сервер работают на вашем компьютере с локальным хранилищем, внешние аккаунты не нужны.

Obsidian MCP

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

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

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

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы