Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

kObsidian

NPM · KOBSIDIAN-MCP · SCANNED SEP 20

Filesystem-first MCP for Obsidian — an LLM-maintained wiki inspired by Karpathy's LLM Wiki.

Available components

0 this week 90 Trust /100
Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security98
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • 39 of 106 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency100
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Cryptographically verified build provenance (signed, bound to bezata/kObsidian). View diagnostics → Pass
  • Clear OSI-approved license (MIT).Pass
  • Actively maintained (last published 17 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability71
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (fair).Partial
  • Tool/resource definitions use about 4371 tokens (~47/item across 92 items; 92 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management93
  • Stability observed for 28 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage71
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 0% of tool parameters carry a description.Fail
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety86
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • 3 of 7 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "tags.remove" implies "remove" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Partial
  • An AI judge read all 92 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

How do I install the kObsidian MCP server?

kObsidian runs locally as an npm package, launched with npx -y kobsidian-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · kobsidian-mcp

# add to Claude Code
claude mcp add bezata-kobsidian-mcp -- npx -y kobsidian-mcp
// .cursor/mcp.json
{
  "mcpServers": {
    "bezata-kobsidian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kobsidian-mcp"
      ]
    }
  }
}
// .vscode/mcp.json
{
  "servers": {
    "bezata-kobsidian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kobsidian-mcp"
      ]
    }
  }
}
# add to Codex CLI
codex mcp add bezata-kobsidian-mcp -- npx -y kobsidian-mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "bezata-kobsidian-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "kobsidian-mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add bezata-kobsidian-mcp --command npx --arg -y --arg kobsidian-mcp
# ~/.hermes/config.yaml
mcp_servers:
  bezata-kobsidian-mcp:
    command: "npx"
    args: ["-y", "kobsidian-mcp"]
// ~/.netclaw/config/netclaw.json
{
  "McpServers": {
    "bezata-kobsidian-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "kobsidian-mcp"
      ]
    }
  }
}
# add to Vellum
assistant mcp add bezata-kobsidian-mcp -t stdio -c npx -a -y kobsidian-mcp
// mcp.json
{
  "mcpServers": {
    "bezata-kobsidian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kobsidian-mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 19 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.

  • 17 Sept 26 −2
    • Stability: pass → 0.83 functional
  • 16 Sept 26 +1
    • Stability: 0.97 → pass security
    • Security disclosure: unverified → pass functional
  • 15 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.

  • 14 Sept 26 −1
    • Security disclosure: pass → unverified functional
  • 13 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.

  • 11 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.

  • 10 Sept 26 −3
    • Stability: pass → 0.80 functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 20 Sept 2026 · Analysed npm/kobsidian-mcp@0.2.1

Provenance Verified

A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.

Result Verified
Ecosystem npm
Reason Verified
Discovered via Registry attestation endpoint
Source repo bezata/kObsidian
Certificate issuer https://token.actions.githubusercontent.com
Certificate SAN https://github.com/bezata/kObsidian/.github/workflows/release.yml@refs/tags/v0.2.1
Rekor log index 1365472890
Predicate type https://slsa.dev/provenance/v1
Subject digest sha512:ea21c9e71915b3f148c74a294ff48b55dd8d50d0d7f21039b533d37e0156356b8c4c853570307126be7eb0022b1233cacf6b1037b2874c9376c533e37

Background: How many MCP packages publish verified provenance →

Dependencies 106 packages
Packages resolved 106
Stale 39
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 92 exposed · ~4,371 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
canvas.addEdge ~55

Connect two nodes in a canvas.

NameTypeReqDescription
filePathstringyes
fromNodestringyes
labelstring
toNodestringyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

canvas.addNode ~81

Add a text or file node to an Obsidian canvas.

NameTypeReqDescription
contentstringyes
filePathstringyes
heightinteger
nodeTypestringyes
vaultPathstring
widthinteger
xnumberyes
ynumberyes
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

canvas.connections ~42

Get incoming and outgoing edges for a canvas node.

NameTypeReqDescription
filePathstringyes
nodeIdstringyes
vaultPathstring

Structured output declared, but exposes no named fields.

No examples provided.

canvas.create ~44

Create a new empty Obsidian canvas (.canvas) file.

NameTypeReqDescription
filePathstringyes
overwriteboolean
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

canvas.parse ~32

Parse an Obsidian canvas file.

NameTypeReqDescription
filePathstringyes
vaultPathstring

Structured output declared, but exposes no named fields.

No examples provided.

canvas.removeNode ~43

Remove a node and its edges from a canvas.

NameTypeReqDescription
filePathstringyes
nodeIdstringyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

commands.execute ~32

Execute an Obsidian command by ID.

NameTypeReqDescription
argsobject
commandIdstringyes

Structured output declared, but exposes no named fields.

No examples provided.

commands.list ~16

List all available Obsidian commands.

Input schema present but exposes no named parameters.

NameTypeReqDescription
itemsarrayyes
totalintegeryes

No examples provided.

commands.search ~25

Search Obsidian commands by ID or name.

NameTypeReqDescription
querystringyes
NameTypeReqDescription
itemsarrayyes
totalintegeryes

No examples provided.

dataview.fields.add ~80

Insert a Dataview field into a note.

NameTypeReqDescription
filePathstringyes
insertAtstring
keystringyes
lineNumberinteger
scopestring
syntaxTypestring
valueyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

dataview.fields.extract ~37

Extract scoped Dataview fields from a note.

NameTypeReqDescription
filePathstringyes
vaultPathstring
NameTypeReqDescription
itemsarrayyes
totalintegeryes

No examples provided.

dataview.fields.remove ~59

Remove a Dataview field from a note.

NameTypeReqDescription
filePathstringyes
keystringyes
lineNumberinteger
scopestring
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

dataview.fields.search ~58

Search notes by Dataview field key and optional value.

NameTypeReqDescription
keystringyes
scopestring
value
valueTypestring
vaultPathstring

Structured output declared, but exposes no named fields.

No examples provided.

dataview.index.read ~48

Read page, list-item, task, DQL, and DataviewJS metadata from a note.

NameTypeReqDescription
filePathstringyes
vaultPathstring

Structured output declared, but exposes no named fields.

No examples provided.

dataview.js.read ~41

Extract fenced dataviewjs blocks from a note without executing them.

NameTypeReqDescription
filePathstringyes
vaultPathstring
NameTypeReqDescription
itemsarrayyes
totalintegeryes

No examples provided.

dataview.js.update ~62

Replace one fenced dataviewjs block source-preservingly.

NameTypeReqDescription
blockIdstring
filePathstringyes
indexinteger
sourcestringyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

dataview.listByFolder ~52

Run a DQL LIST query for a folder.

NameTypeReqDescription
folderstringyes
limitinteger
sortBystring
whereClausestring

Structured output declared, but exposes no named fields.

No examples provided.

dataview.listByTag ~52

Run a DQL LIST query for a tag.

NameTypeReqDescription
limitinteger
sortBystring
tagstringyes
whereClausestring

Structured output declared, but exposes no named fields.

No examples provided.

dataview.query ~36

Execute a Dataview Query Language (DQL) query through the Obsidian API.

NameTypeReqDescription
querystringyes

Structured output declared, but exposes no named fields.

No examples provided.

dataview.query.read ~39

Extract fenced dataview DQL blocks from a note.

NameTypeReqDescription
filePathstringyes
vaultPathstring
NameTypeReqDescription
itemsarrayyes
totalintegeryes

No examples provided.

dataview.query.update ~63

Replace one fenced dataview DQL block source-preservingly.

NameTypeReqDescription
blockIdstring
filePathstringyes
indexinteger
sourcestringyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

dataview.table ~55

Run a DQL TABLE query.

NameTypeReqDescription
fieldsarrayyes
fromClausestring
limitinteger
sortBystring
whereClausestring

Structured output declared, but exposes no named fields.

No examples provided.

kanban.addCard ~73

Add a card to a Kanban column.

NameTypeReqDescription
cardTextstringyes
columnNamestringyes
dueDatestring
filePathstringyes
positionstring
statusstring
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

kanban.moveCard ~65

Move a card between Kanban columns.

NameTypeReqDescription
cardTextstringyes
filePathstringyes
fromColumnstringyes
positionstring
toColumnstringyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

kanban.parse ~33

Parse a markdown Kanban board file.

NameTypeReqDescription
filePathstringyes
vaultPathstring

Structured output declared, but exposes no named fields.

No examples provided.

kanban.stats ~37

Get card counts and completion rates for a Kanban board.

NameTypeReqDescription
filePathstringyes
vaultPathstring

Structured output declared, but exposes no named fields.

No examples provided.

kanban.toggleCard ~51

Toggle a Kanban card complete/incomplete.

NameTypeReqDescription
cardTextstringyes
columnNamestring
filePathstringyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

links.backlinks ~49

Find notes that link to a target note.

NameTypeReqDescription
contextLengthinteger
includeContextboolean
pathstringyes
vaultPathstring
NameTypeReqDescription
itemsarrayyes
totalintegeryes

No examples provided.

links.broken ~35

Find broken note links in the vault or a folder.

NameTypeReqDescription
directorystring
vaultPathstring
NameTypeReqDescription
itemsarrayyes
totalintegeryes

No examples provided.

links.connections ~39

Explore direct and multi-hop note connections.

NameTypeReqDescription
depthinteger
noteNamestringyes
vaultPathstring

Structured output declared, but exposes no named fields.

No examples provided.

links.graph ~22

Build the vault link graph.

NameTypeReqDescription
vaultPathstring

Structured output declared, but exposes no named fields.

No examples provided.

links.health ~26

Summarize link density and broken-link metrics.

NameTypeReqDescription
vaultPathstring

Structured output declared, but exposes no named fields.

No examples provided.

links.hubs ~33

Find notes with many outgoing links.

NameTypeReqDescription
minOutlinksinteger
vaultPathstring
NameTypeReqDescription
itemsarrayyes
totalintegeryes

No examples provided.

links.orphaned ~27

Find notes with no incoming or outgoing links.

NameTypeReqDescription
vaultPathstring
NameTypeReqDescription
itemsarrayyes
totalintegeryes

No examples provided.

links.outgoing ~39

Extract links referenced by a note.

NameTypeReqDescription
checkValidityboolean
pathstringyes
vaultPathstring
NameTypeReqDescription
itemsarrayyes
totalintegeryes

No examples provided.

marp.deck.read ~41

Read Marp deck frontmatter, slides, directives, and source spans.

NameTypeReqDescription
filePathstringyes
vaultPathstring

Structured output declared, but exposes no named fields.

No examples provided.

marp.frontmatter.update ~47

Update selected Marp deck frontmatter fields while preserving unrelated source.

NameTypeReqDescription
fieldsobjectyes
filePathstringyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

marp.slides.list ~37

List Marp slides with separator and directive metadata.

NameTypeReqDescription
filePathstringyes
vaultPathstring
NameTypeReqDescription
itemsarrayyes
totalintegeryes

No examples provided.

marp.slides.read ~52

Read one Marp slide source-preservingly.

NameTypeReqDescription
filePathstringyes
indexinteger
slideIdstring
vaultPathstring

Structured output declared, but exposes no named fields.

No examples provided.

marp.slides.update ~60

Replace one Marp slide body without rewriting neighboring slides.

NameTypeReqDescription
filePathstringyes
indexinteger
slideIdstring
sourcestringyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

mermaid.blocks.list ~38

List fenced Mermaid blocks in a note or across the vault.

NameTypeReqDescription
filePathstring
vaultPathstring
NameTypeReqDescription
itemsarrayyes
totalintegeryes

No examples provided.

mermaid.blocks.read ~55

Read one Mermaid block with source spans, directives, and config metadata.

NameTypeReqDescription
blockIdstring
filePathstringyes
indexinteger
vaultPathstring

Structured output declared, but exposes no named fields.

No examples provided.

mermaid.blocks.update ~58

Replace one fenced Mermaid block source-preservingly.

NameTypeReqDescription
blockIdstring
filePathstringyes
indexinteger
sourcestringyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

notes.append ~40

Append content to the end of a note.

NameTypeReqDescription
contentstringyes
filePathstringyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

notes.create ~46

Create a new note using filesystem-first behavior.

NameTypeReqDescription
contentstringyes
overwriteboolean
pathstringyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

notes.createFolder ~32

Create a folder in the vault.

NameTypeReqDescription
folderPathstringyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

notes.delete ~30

Delete a note from the vault.

NameTypeReqDescription
pathstringyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

notes.info ~39

Get note metadata and lightweight statistics without loading the result into a client-specific schema.

NameTypeReqDescription
pathstringyes
vaultPathstring

Structured output declared, but exposes no named fields.

No examples provided.

notes.insertAfterBlock ~48

Insert content after a block reference.

NameTypeReqDescription
blockIdstringyes
contentstringyes
filePathstringyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

notes.insertAfterHeading ~48

Insert content immediately after a markdown heading.

NameTypeReqDescription
contentstringyes
filePathstringyes
headingstringyes
vaultPathstring
NameTypeReqDescription
changedbooleanyes
summarystringyes
targetstringyes

No examples provided.

Common questions

What is the kObsidian MCP server?

kObsidian is an MCP server listed in the public MCP registry as io.github.bezata/kobsidian-mcp. Filesystem-first MCP for Obsidian, an LLM-maintained wiki inspired by Karpathy's LLM Wiki. This page covers its npm package (kobsidian-mcp).

Is the kObsidian MCP server safe to use?

kObsidian scores 90 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the kObsidian MCP server expose?

kObsidian exposes 92 tools: notes.read, notes.create, notes.update, notes.delete, notes.search, and 87 more. Their descriptions and schemas cost roughly 4,371 tokens of context every time the server is loaded.

Is the kObsidian MCP server still maintained?

kObsidian is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the kObsidian MCP server under?

kObsidian declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.