obsidian-sync-mcp — MCP-сервер для Claude Code: доступ к Obsidian
Даёт ИИ-агенту доступ к вашему хранилищу Obsidian: читает заметки из папки или из CouchDB через Self-hosted LiveSync.
claude mcp add --env VAULT_PATH=<VAULT_PATH> --env COUCHDB_URL=<COUCHDB_URL> --env COUCHDB_USER=<COUCHDB_USER> --env COUCHDB_PASSWORD=<COUCHDB_PASSWORD> --env COUCHDB_DATABASE=<COUCHDB_DATABASE> --transport stdio obsidian-sync-mcp -- npx -y obsidian-sync-mcpЧто делает obsidian-sync-mcp
Сервер подключается к хранилищу двумя способами. В режиме файловой системы он читает .md прямо из папки хранилища, база данных не нужна. В режиме CouchDB он берёт данные из базы — локальной или в облаке, куда хранилище попадает через плагин Self-hosted LiveSync. Разбор чанков и шифрование на стороне клиента обеспечивает livesync-commonlib, та же библиотека, на которой работает сам плагин.
Оба режима отдают агенту один и тот же набор инструментов, и подключиться может любой клиент с поддержкой Model Context Protocol. Запуск локальный: npx obsidian-sync-mcp с переменными VAULT_PATH и VAULT_NAME для файлового режима либо с COUCHDB_URL, COUCHDB_USER, COUCHDB_PASSWORD, COUCHDB_DATABASE для CouchDB. Машина при этом должна быть включена, иначе агент до сервера не дотянется.
Если нужен доступ постоянно, сервер разворачивают рядом с CouchDB на всегда включённом хосте — скриптом для Fly.io или через Docker. Для шифрованного хранилища задайте COUCHDB_PASSPHRASE, а при включённом «Obfuscate Properties» — COUCHDB_OBFUSCATE_PROPERTIES=true. Хранилище, созданное в LiveSync 1.0.33+ с обфускацией путей, потребует ещё и COUCHDB_ID_DERIVATION_KEY с кодом восстановления вида sls-id-v1:...: без него сервер не разберёт пути к заметкам.
Какие задачи решает
- вытащить содержимое сегодняшней заметки из хранилища Obsidian
- найти нужные заметки по всему хранилищу и вернуть ссылки на них
- дать агенту читать хранилище, не открывая Obsidian
- работать с заметками с телефона, когда компьютер выключен
- подключить хранилище к агенту через CouchDB с шифрованием
Примеры запросов агенту
- Что лежит в моей заметке за сегодня?
- Найди в хранилище все заметки про MCP и дай ссылки на них
- Прочитай заметку
projects/roadmap.mdи перескажи план
Как установить obsidian-sync-mcp
Командой платформы
claude mcp add --env VAULT_PATH=<VAULT_PATH> --env COUCHDB_URL=<COUCHDB_URL> --env COUCHDB_USER=<COUCHDB_USER> --env COUCHDB_PASSWORD=<COUCHDB_PASSWORD> --env COUCHDB_DATABASE=<COUCHDB_DATABASE> --transport stdio obsidian-sync-mcp -- npx -y obsidian-sync-mcpВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Командой платформы
codex mcp add obsidian-sync-mcp --env VAULT_PATH=<VAULT_PATH> --env COUCHDB_URL=<COUCHDB_URL> --env COUCHDB_USER=<COUCHDB_USER> --env COUCHDB_PASSWORD=<COUCHDB_PASSWORD> --env COUCHDB_DATABASE=<COUCHDB_DATABASE> -- npx -y obsidian-sync-mcpВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"obsidian-sync-mcp": {
"command": "npx",
"args": [
"-y",
"obsidian-sync-mcp"
],
"env": {
"VAULT_PATH": "<VAULT_PATH>",
"COUCHDB_URL": "<COUCHDB_URL>",
"COUCHDB_USER": "<COUCHDB_USER>",
"COUCHDB_PASSWORD": "<COUCHDB_PASSWORD>",
"COUCHDB_DATABASE": "<COUCHDB_DATABASE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"obsidian-sync-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"obsidian-sync-mcp"
],
"env": {
"VAULT_PATH": "<VAULT_PATH>",
"COUCHDB_URL": "<COUCHDB_URL>",
"COUCHDB_USER": "<COUCHDB_USER>",
"COUCHDB_PASSWORD": "<COUCHDB_PASSWORD>",
"COUCHDB_DATABASE": "<COUCHDB_DATABASE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e VAULT_PATH=<VAULT_PATH> -e COUCHDB_URL=<COUCHDB_URL> -e COUCHDB_USER=<COUCHDB_USER> -e COUCHDB_PASSWORD=<COUCHDB_PASSWORD> -e COUCHDB_DATABASE=<COUCHDB_DATABASE> obsidian-sync-mcp npx -y obsidian-sync-mcpВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о obsidian-sync-mcp
Как установить obsidian-sync-mcp в Claude Code?
Добавьте сервер командой `claude mcp add obsidian-sync-mcp -e COUCHDB_PASSWORD=<COUCHDB_PASSWORD> -e COUCHDB_PASSPHRASE=<COUCHDB_PASSPHRASE> -e MCP_AUTH_TOKEN=<MCP_AUTH_TOKEN> -- npx -y obsidian-sync-mcp. Для файлового режима есть второй вариант: claude mcp add --env VAULT_PATH=<VAULT_PATH> --env COUCHDB_URL=<COUCHDB_URL> --env COUCHDB_USER=<COUCHDB_USER> --env COUCHDB_PASSWORD=<COUCHDB_PASSWORD> --env COUCHDB_DATABASE=<COUCHDB_DATABASE> --transport stdio obsidian-sync-mcp -- npx -y obsidian-sync-mcp`.
Что делает obsidian-sync-mcp?
Открывает агенту доступ к хранилищу Obsidian по Model Context Protocol. Читает заметки либо напрямую из файлов, либо из CouchDB, куда их синхронизирует Self-hosted LiveSync.
Что нужно для режима CouchDB?
Адрес базы, логин, пароль и имя базы. При шифровании в LiveSync добавьте COUCHDB_PASSPHRASE, а для хранилища с обфускацией путей — COUCHDB_ID_DERIVATION_KEY с кодом восстановления.
