Name: kObsidian
Author: bezata

LABSCO SUMMARY

The Obsidian server that does not need Obsidian open.

Obsidian stays closed for 55+ of the 66 tools, because the vault is just files — that is what makes this usable from a headless agent or a CI job. The REST-bridged namespaces are the exception and they are clearly fenced off, so you can decide whether the plugin key is worth adding. A 66-tool surface is a lot of tool definitions to carry every turn; budget for it.

What it is

A filesystem-first MCP server for Obsidian vaults, with an LLM-Wiki layer on top. It reads and writes the vault directly rather than through the app, so most of the surface works whether or not Obsidian is running, and it can discover and switch between several vaults inside one session.

What you get

66 tools across 16 namespaces — every one Zod-validated with structuredContent output and the full four-hint MCP annotation set
Notes read, created, edited, moved, deleted, listed and searched — notes.read, notes.create, notes.edit, notes.search and four more
Link analysis as its own namespace: links.backlinks, links.broken, links.orphaned, links.hubs, links.graph and links.health
Multi-vault switching in-session — vault.list discovers known vaults from Obsidian's own registry, vault.select switches, no restart or config edit
Tasks in the Tasks-plugin format, Dataview queries and field writes, Canvas, Kanban, Marp decks and fenced blocks, each with its own namespace
A wiki.* namespace that ingests sources, rebuilds an index and a greppable log, and lints for orphans, broken links and stale pages
Four URI-addressable resources under kobsidian://wiki/… and three server-side prompts (ingest-source, answer-from-wiki, health-check-wiki)

Requirements

OBSIDIAN_VAULT_PATH is required everywhere — the absolute path to the vault. The Local REST API plugin is optional and only unlocks workspace.*, commands.* and live dataview.query*; those need OBSIDIAN_API_URL (default https://127.0.0.1:27124) and OBSIDIAN_REST_API_KEY, plus OBSIDIAN_API_VERIFY_TLS if you have trusted the plugin's self-signed certificate. Run it as npx -y kobsidian-mcp 0.3.4 over stdio, or over Streamable HTTP; cross-platform .mcpb bundles ship for Claude Desktop drag-and-drop. Swap npx for bunx for a faster cold start.

Setup effort

One command — npx -y kobsidian-mcp

See installation options

USE CASES

01

Answering from notes you already wrote

Search the vault, then read the matching notes' content and metadata instead of working from filenames.

notes.searchnotes.read

02

Cleaning up a vault that has drifted

List broken and orphaned links, check overall link health, and fix the notes the report points at.

links.brokenlinks.orphanedlinks.health

03

Working across two vaults in one conversation

List the vaults the server can see, select one for the session, and switch again later without editing config or restarting the client.

vault.listvault.select

04

Turning collected sources into a maintained wiki

Ingest a source, let the index and log rebuild, then lint for orphans and stale pages before asking questions against it.

wiki.ingestwiki.indexRebuildwiki.lintwiki.query

66 tools

Listed in project docs. Your client may show a different list.

vault.list

vault.current

vault.select

vault.reset

notes.read

notes.create

notes.edit

notes.frontmatter

notes.delete

notes.move

notes.list

notes.search

tags.modify

tags.search

tags.analyze

BEFORE YOU INSTALL

What to know first

Tools you get

66 tools named in the project's documentation.

Requires

npx on PATH
OBSIDIAN_VAULT_PATH in your environment

Optional

OBSIDIAN_REST_API_KEY in your environment

INSTALLATION

Connect your client

Server setup

TERMINAL

npx -y kobsidian-mcp

<YOUR_OBSIDIAN_REST_API_KEY> is the bearer key of the Obsidian Local REST API plugin. It is needed only for the workspace, commands and live Dataview tools; without the plugin, leave OBSIDIAN_REST_API_KEY and OBSIDIAN_API_URL out.

MCP Clients

Claude Code

CLAUDE CODE · TERMINAL

claude mcp add kobsidian -s user --env OBSIDIAN_VAULT_PATH=<YOUR_OBSIDIAN_VAULT_PATH> --env OBSIDIAN_API_URL=https://127.0.0.1:27124 --env OBSIDIAN_REST_API_KEY=<YOUR_OBSIDIAN_REST_API_KEY> -- npx -y kobsidian-mcp

Claude Desktop

Download the .mcpb bundle for your platform from the latest release at https://github.com/bezata/kObsidian/releases/latest — kobsidian-darwin-arm64.mcpb (Apple Silicon Mac), kobsidian-darwin-x64.mcpb (Intel Mac), kobsidian-windows-x64.mcpb, kobsidian-linux-x64.mcpb or kobsidian-linux-arm64.mcpb

Drag it into Claude Desktop. The installer prompts for your vault path and the optional API URL / key.

Codex

CODEX · TERMINAL

codex mcp add kobsidian --env OBSIDIAN_VAULT_PATH=<YOUR_OBSIDIAN_VAULT_PATH> --env OBSIDIAN_API_URL=https://127.0.0.1:27124 --env OBSIDIAN_REST_API_KEY=<YOUR_OBSIDIAN_REST_API_KEY> -- npx -y kobsidian-mcp

Cursor, Antigravity, Any MCP client

JSON

{
  "mcpServers": {
    "kobsidian": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kobsidian-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<YOUR_OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_API_URL": "https://127.0.0.1:27124",
        "OBSIDIAN_REST_API_KEY": "<YOUR_OBSIDIAN_REST_API_KEY>"
      }
    }
  }
}

VS Code

VS CODE · TERMINAL

code --add-mcp '{"name":"kobsidian","command":"npx","args":["-y","kobsidian-mcp"],"env":{"OBSIDIAN_VAULT_PATH":"<YOUR_OBSIDIAN_VAULT_PATH>","OBSIDIAN_API_URL":"https://127.0.0.1:27124","OBSIDIAN_REST_API_KEY":"<YOUR_OBSIDIAN_REST_API_KEY>"}}'

Gemini CLI

GEMINI CLI · TERMINAL

gemini mcp add kobsidian --env OBSIDIAN_VAULT_PATH=<YOUR_OBSIDIAN_VAULT_PATH> --env OBSIDIAN_API_URL=https://127.0.0.1:27124 --env OBSIDIAN_REST_API_KEY=<YOUR_OBSIDIAN_REST_API_KEY> -- npx -y kobsidian-mcp

Zed

ZED · JSON

{
  "context_servers": {
    "kobsidian": {
      "source": "custom",
      "command": "npx",
      "args": [
        "-y",
        "kobsidian-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<YOUR_OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_API_URL": "https://127.0.0.1:27124",
        "OBSIDIAN_REST_API_KEY": "<YOUR_OBSIDIAN_REST_API_KEY>"
      }
    }
  }
}

OpenCode

OPENCODE · JSON

{
  "mcp": {
    "kobsidian": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "kobsidian-mcp"
      ],
      "environment": {
        "OBSIDIAN_VAULT_PATH": "<YOUR_OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_API_URL": "https://127.0.0.1:27124",
        "OBSIDIAN_REST_API_KEY": "<YOUR_OBSIDIAN_REST_API_KEY>"
      }
    }
  }
}

Factory Droid

FACTORY DROID

droid mcp add kobsidian "npx -y kobsidian-mcp" --env OBSIDIAN_VAULT_PATH=<YOUR_OBSIDIAN_VAULT_PATH> --env OBSIDIAN_API_URL=https://127.0.0.1:27124 --env OBSIDIAN_REST_API_KEY=<YOUR_OBSIDIAN_REST_API_KEY>

kObsidian