kObsidian

NPM · KOBSIDIAN-MCP · SCANNED AUG 3

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

Available components

+24 this week 73 73 Trust /100

Trust breakdown (6 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 →

Supply Chain Security83

No malware found by supply-chain analysis.Pass
CVE check failed: a known medium-severity CVE affects @hono/node-server 1.19.17, reached via @modelcontextprotocol/sdk > @hono/node-server. A fixed version is available. View diagnostics → Fail
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (105 of 109), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency97

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
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability64

100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
AI-judged instruction clarity (poor).Fail
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 Management27

Stability observed for 8 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

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · kobsidian-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add bezata-kobsidian-mcp -- npx -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"]

// 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.

3 Aug 26 +4
- Stability: unverified → 0.27 ▲ functional
2 Aug 26 +46
- GHSA-frvp-7c67-39w9 affects this package: medium ▼ security
- Known CVEs: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Provenance: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- The attested source repository moved: bezata/kObsidian security
- MCP protocol: unverified → pass ▲ functional
- Schema quality: unverified → poor ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- Licence: MIT functional
31 Jul 26 −26
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
27 Jul 26 49

First indexed and scored.

Show 2 earlier entries Hide earlier entries

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 3 Aug 2026 · Analysed npm/[email protected]

Provenance verified

Ecosystem: npm · Outcome: verified

Reason: verified

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
Discovery method:: attestation_endpoint

Vulnerabilities 1 finding

ID	CVE	Severity	Vector	Fix available
GHSA-frvp-7c67-39w9		medium	CVSS:3.1/AV:N/AC:H/PR:N/UI:N/S:U/C:H/I:N/A:N	yes

Dependencies 105 packages

105 packages in the resolved dependency tree · 105 deprecated · 37 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

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.

Tool Tokens

canvas.addEdge Add Canvas Edge ~55

Connect two nodes in a canvas.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
fromNode	string	yes	—
label	string	—	—
toNode	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

canvas.addNode Add Canvas Node ~81

Add a text or file node to an Obsidian canvas.

Input Output Examples

Name	Type	Req	Description
content	string	yes	—
filePath	string	yes	—
height	integer	—	—
nodeType	string	yes	—
vaultPath	string	—	—
width	integer	—	—
x	number	yes	—
y	number	yes	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

canvas.connections Canvas Node Connections ~42

Get incoming and outgoing edges for a canvas node.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
nodeId	string	yes	—
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

canvas.create Create Canvas ~44

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

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
overwrite	boolean	—	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

canvas.parse Parse Canvas ~32

Parse an Obsidian canvas file.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

canvas.removeNode Remove Canvas Node ~43

Remove a node and its edges from a canvas.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
nodeId	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

commands.execute Execute Command ~32

Execute an Obsidian command by ID.

Input Output Examples

Name	Type	Req	Description
args	object	—	—
commandId	string	yes	—

Structured output declared, but exposes no named fields.

No examples provided.

commands.list List Commands ~16

List all available Obsidian commands.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
items	array	yes	—
total	integer	yes	—

No examples provided.

commands.search Search Commands ~25

Search Obsidian commands by ID or name.

Input Output Examples

Name	Type	Req	Description
query	string	yes	—

Name	Type	Req	Description
items	array	yes	—
total	integer	yes	—

No examples provided.

dataview.fields.add Add Dataview Field ~80

Insert a Dataview field into a note.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
insertAt	string	—	—
key	string	yes	—
lineNumber	integer	—	—
scope	string	—	—
syntaxType	string	—	—
value	—	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

dataview.fields.extract Extract Dataview Fields ~37

Extract scoped Dataview fields from a note.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
items	array	yes	—
total	integer	yes	—

No examples provided.

dataview.fields.remove Remove Dataview Field ~59

Remove a Dataview field from a note.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
key	string	yes	—
lineNumber	integer	—	—
scope	string	—	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

dataview.fields.search Search Dataview Fields ~58

Search notes by Dataview field key and optional value.

Input Output Examples

Name	Type	Req	Description
key	string	yes	—
scope	string	—	—
value	—	—	—
valueType	string	—	—
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

dataview.index.read Read Dataview Index ~48

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

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

dataview.js.read Read DataviewJS Blocks ~41

Extract fenced dataviewjs blocks from a note without executing them.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
items	array	yes	—
total	integer	yes	—

No examples provided.

dataview.js.update Update DataviewJS Block ~62

Replace one fenced dataviewjs block source-preservingly.

Input Output Examples

Name	Type	Req	Description
blockId	string	—	—
filePath	string	yes	—
index	integer	—	—
source	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

dataview.listByFolder List Notes By Folder (DQL) ~52

Run a DQL LIST query for a folder.

Input Output Examples

Name	Type	Req	Description
folder	string	yes	—
limit	integer	—	—
sortBy	string	—	—
whereClause	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

dataview.listByTag List Notes By Tag (DQL) ~52

Run a DQL LIST query for a tag.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	—
sortBy	string	—	—
tag	string	yes	—
whereClause	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

dataview.query Run Dataview Query ~36

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

Input Output Examples

Name	Type	Req	Description
query	string	yes	—

Structured output declared, but exposes no named fields.

No examples provided.

dataview.query.read Read Dataview Query Blocks ~39

Extract fenced dataview DQL blocks from a note.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
items	array	yes	—
total	integer	yes	—

No examples provided.

dataview.query.update Update Dataview Query Block ~63

Replace one fenced dataview DQL block source-preservingly.

Input Output Examples

Name	Type	Req	Description
blockId	string	—	—
filePath	string	yes	—
index	integer	—	—
source	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

dataview.table Table Query (DQL) ~55

Run a DQL TABLE query.

Input Output Examples

Name	Type	Req	Description
fields	array	yes	—
fromClause	string	—	—
limit	integer	—	—
sortBy	string	—	—
whereClause	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

kanban.addCard Add Kanban Card ~73

Add a card to a Kanban column.

Input Output Examples

Name	Type	Req	Description
cardText	string	yes	—
columnName	string	yes	—
dueDate	string	—	—
filePath	string	yes	—
position	string	—	—
status	string	—	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

kanban.moveCard Move Kanban Card ~65

Move a card between Kanban columns.

Input Output Examples

Name	Type	Req	Description
cardText	string	yes	—
filePath	string	yes	—
fromColumn	string	yes	—
position	string	—	—
toColumn	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

kanban.parse Parse Kanban Board ~33

Parse a markdown Kanban board file.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

kanban.stats Kanban Statistics ~37

Get card counts and completion rates for a Kanban board.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

kanban.toggleCard Toggle Kanban Card ~51

Toggle a Kanban card complete/incomplete.

Input Output Examples

Name	Type	Req	Description
cardText	string	yes	—
columnName	string	—	—
filePath	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

links.backlinks Get Backlinks ~49

Find notes that link to a target note.

Input Output Examples

Name	Type	Req	Description
contextLength	integer	—	—
includeContext	boolean	—	—
path	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
items	array	yes	—
total	integer	yes	—

No examples provided.

links.broken Find Broken Links ~35

Find broken note links in the vault or a folder.

Input Output Examples

Name	Type	Req	Description
directory	string	—	—
vaultPath	string	—	—

Name	Type	Req	Description
items	array	yes	—
total	integer	yes	—

No examples provided.

links.connections Get Note Connections ~39

Explore direct and multi-hop note connections.

Input Output Examples

Name	Type	Req	Description
depth	integer	—	—
noteName	string	yes	—
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

links.graph Get Link Graph ~22

Build the vault link graph.

Input Output Examples

Name	Type	Req	Description
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

links.health Analyze Link Health ~26

Summarize link density and broken-link metrics.

Input Output Examples

Name	Type	Req	Description
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

links.hubs Find Hub Notes ~33

Find notes with many outgoing links.

Input Output Examples

Name	Type	Req	Description
minOutlinks	integer	—	—
vaultPath	string	—	—

Name	Type	Req	Description
items	array	yes	—
total	integer	yes	—

No examples provided.

links.orphaned Find Orphaned Notes ~27

Find notes with no incoming or outgoing links.

Input Output Examples

Name	Type	Req	Description
vaultPath	string	—	—

Name	Type	Req	Description
items	array	yes	—
total	integer	yes	—

No examples provided.

links.outgoing Get Outgoing Links ~39

Extract links referenced by a note.

Input Output Examples

Name	Type	Req	Description
checkValidity	boolean	—	—
path	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
items	array	yes	—
total	integer	yes	—

No examples provided.

marp.deck.read Read Marp Deck ~41

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

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

marp.frontmatter.update Update Marp Frontmatter ~47

Update selected Marp deck frontmatter fields while preserving unrelated source.

Input Output Examples

Name	Type	Req	Description
fields	object	yes	—
filePath	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

marp.slides.list List Marp Slides ~37

List Marp slides with separator and directive metadata.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
items	array	yes	—
total	integer	yes	—

No examples provided.

marp.slides.read Read Marp Slide ~52

Read one Marp slide source-preservingly.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
index	integer	—	—
slideId	string	—	—
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

marp.slides.update Update Marp Slide ~60

Replace one Marp slide body without rewriting neighboring slides.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
index	integer	—	—
slideId	string	—	—
source	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

mermaid.blocks.list List Mermaid Blocks ~38

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

Input Output Examples

Name	Type	Req	Description
filePath	string	—	—
vaultPath	string	—	—

Name	Type	Req	Description
items	array	yes	—
total	integer	yes	—

No examples provided.

mermaid.blocks.read Read Mermaid Block ~55

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

Input Output Examples

Name	Type	Req	Description
blockId	string	—	—
filePath	string	yes	—
index	integer	—	—
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

mermaid.blocks.update Update Mermaid Block ~58

Replace one fenced Mermaid block source-preservingly.

Input Output Examples

Name	Type	Req	Description
blockId	string	—	—
filePath	string	yes	—
index	integer	—	—
source	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

notes.append Append To Note ~40

Append content to the end of a note.

Input Output Examples

Name	Type	Req	Description
content	string	yes	—
filePath	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

notes.create Create Note ~46

Create a new note using filesystem-first behavior.

Input Output Examples

Name	Type	Req	Description
content	string	yes	—
overwrite	boolean	—	—
path	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

notes.createFolder Create Folder ~32

Create a folder in the vault.

Input Output Examples

Name	Type	Req	Description
folderPath	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

notes.delete Delete Note ~30

Delete a note from the vault.

Input Output Examples

Name	Type	Req	Description
path	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

notes.info Note Info ~39

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

Input Output Examples

Name	Type	Req	Description
path	string	yes	—
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

notes.insertAfterBlock Insert After Block ~48

Insert content after a block reference.

Input Output Examples

Name	Type	Req	Description
blockId	string	yes	—
content	string	yes	—
filePath	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

notes.insertAfterHeading Insert After Heading ~48

Insert content immediately after a markdown heading.

Input Output Examples

Name	Type	Req	Description
content	string	yes	—
filePath	string	yes	—
heading	string	yes	—
vaultPath	string	—	—

Name	Type	Req	Description
changed	boolean	yes	—
summary	string	yes	—
target	string	yes	—

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug