# obsidian-sync-mcp

Даёт ИИ-агенту доступ к вашему хранилищу Obsidian: читает заметки из папки или из CouchDB через Self-hosted LiveSync.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 66
- Автор: es617
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/es617/obsidian-sync-mcp
- Обновлён: 2026-10-18
- HTML: https://affpapa.org/nevibecode/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:...`: без него сервер не разберёт пути к заметкам.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `VAULT_PATH`, `COUCHDB_URL`, `COUCHDB_USER`, `COUCHDB_PASSWORD`, `COUCHDB_DATABASE`, `COUCHDB_PASSPHRASE`, `COUCHDB_OBFUSCATE_PROPERTIES`, `VAULT_NAME`, `MCP_AUTH_TOKEN`, `BASE_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.
- Работает с: Obsidian

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

## Когда брать
- вытащить содержимое сегодняшней заметки из хранилища Obsidian
- найти нужные заметки по всему хранилищу и вернуть ссылки на них
- дать агенту читать хранилище, не открывая Obsidian
- работать с заметками с телефона, когда компьютер выключен
- подключить хранилище к агенту через CouchDB с шифрованием

## Примеры запросов агенту
- Что лежит в моей заметке за сегодня?
- Найди в хранилище все заметки про MCP и дай ссылки на них
- Прочитай заметку `projects/roadmap.md` и перескажи план

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md