ykoellmann/obsidian-mcp

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

4 stars 6 forks Качество 83 Тренд 32MIT

Self-hosted MCP server for Obsidian vaults. One source of truth, accessible from anywhere. No Obsidian app locally required.

Обзор

An MCP (Model Context Protocol) server for Obsidian vaults. Connects Claude (or any MCP client) directly to your vault — read, write, search, navigate links, and manage notes, canvases, and kanban boards. The official Obsidian MCP plugin requires the Obsidian desktop app to be running and only works on the same machine. — no Obsidian app needed. The intended setup is to host obsidian-mcp on a server or NAS where your vault is continuously synced (via Syncthing, git, rclone, or Obsidian Sync). Claude then connects to that server over the network, so: - — the server sees every change your Obsidian app writes, immediately - — connect from Claude Desktop, Claude Code, or any MCP client on any machine, without the vault being present locally - — several Claude sessions can read the vault simultaneously; writes are serialized with per-file locking - — the server runs headless and starts automatically (systemd, Docker, etc.

README

Показан фрагмент оригинального README. Открыть оригинал.

obsidian-mcp

Why obsidian-mcp?

The official Obsidian MCP plugin requires the Obsidian desktop app to be running and only works on the same machine. obsidian-mcp is a standalone server — no Obsidian app needed.

The intended setup is to host obsidian-mcp on a server or NAS where your vault is continuously synced (via Syncthing, git, rclone, or Obsidian Sync). Claude then connects to that server over the network, so:

Always up to date — the server sees every change your Obsidian app writes, immediately
Access from anywhere — connect from Claude Desktop, Claude Code, or any MCP client on any machine, without the vault being present locally
Multiple clients — several Claude sessions can read the vault simultaneously; writes are serialized with per-file locking
No app dependency — the server runs headless and starts automatically (systemd, Docker, etc.)

[Obsidian app]  ──sync──►  [vault on server]  ◄──MCP──  [Claude on any machine]
  (phone/laptop)              (NAS / VPS)                  (Claude Desktop / Code)

Features

Read & Search — read notes, search full-text (exact/regex/fuzzy, optionally combined with a frontmatter filter or scoped to filenames), render embedded transclusions, inspect note outlines, list every file in the vault regardless of type
Duplicate prevention — find_similar_notes_tool ranks notes by TF-IDF similarity so a new note doesn’t duplicate an existing one under different wording
Schema linting — lint_schema_tool validates frontmatter against the enums declared in your own _AI_INSTRUCTIONS.md, plus an optional cron-friendly health-check script
Write — create/overwrite notes (with automatic frontmatter preservation, dry-run previews, and unified diffs), patch sections or anchor-less body text, append content, update frontmatter (single or batch), manage tags, move notes with automatic wikilink rewriting
Optimistic concurrency — every read returns a revision; pass it back to a write to detect edits landed by Obsidian Sync in between
Folders — list (optionally recursive with a full tree dump), create, delete, rename folders; renaming rewrites path-based wikilinks vault-wide
Query & Graph — backlinks, broken links, orphan detection, BFS link graph, vault stats, task collection across vault

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "obsidian": {
      "command": "uv",
      "args": ["--directory", "/path/to/obsidian-mcp", "run", "obsidian-remote-mcp"],
      "env": {
        "VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}