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

notes.list List Notes ~39

List notes in the vault or a folder.

Input Output Examples

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

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

No examples provided.

notes.listFolders List Folders ~37

List folders in the vault.

Input Output Examples

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

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

No examples provided.

notes.move Move Note ~51

Move a note and optionally update links that reference it.

Input Output Examples

Name	Type	Req	Description
destinationPath	string	yes	—
sourcePath	string	yes	—
updateLinks	boolean	—	—
vaultPath	string	—	—

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

No examples provided.

notes.moveFolder Move Folder ~52

Move a folder and optionally update links inside the vault.

Input Output Examples

Name	Type	Req	Description
destinationFolder	string	yes	—
sourceFolder	string	yes	—
updateLinks	boolean	—	—
vaultPath	string	—	—

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

No examples provided.

notes.read Read Note ~33

Read a note from the vault with parsed metadata.

Input Output Examples

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

Structured output declared, but exposes no named fields.

No examples provided.

notes.search Search Notes ~46

Search notes by text with lightweight support for tag: and path: filters.

Input Output Examples

Name	Type	Req	Description
contextLength	integer	—	—
query	string	yes	—
vaultPath	string	—	—

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

No examples provided.

notes.searchByDate Search Notes By Date ~49

List notes by created or modified date.

Input Output Examples

Name	Type	Req	Description
dateType	string	—	—
daysAgo	integer	—	—
operator	string	—	—
vaultPath	string	—	—

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

No examples provided.

notes.update Update Note ~59

Update an existing note, replacing or appending content.

Input Output Examples

Name	Type	Req	Description
content	string	yes	—
createIfNotExists	boolean	—	—
mergeStrategy	string	—	—
path	string	yes	—
vaultPath	string	—	—

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

No examples provided.

notes.updateFrontmatter Update Frontmatter ~46

Create or update a frontmatter field.

Input Output Examples

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

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

No examples provided.

stats.note Note Statistics ~31

Get statistics for a single note.

Input Output Examples

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

Structured output declared, but exposes no named fields.

No examples provided.

stats.vault Vault Statistics ~25

Get aggregate statistics for the whole vault.

Input Output Examples

Name	Type	Req	Description
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

system.version Server Version ~24

Return the running kObsidian server name, version, and host runtime.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
name	string	yes	—
runtime	string	yes	—
runtimeVersion	string	yes	—
summary	string	yes	—
version	string	yes	—

No examples provided.

tags.add Add Tags ~39

Add tags to a note frontmatter block.

Input Output Examples

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

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

No examples provided.

tags.analyze Analyze Tags ~34

Extract frontmatter and inline tags from a note.

Input Output Examples

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

Structured output declared, but exposes no named fields.

No examples provided.

tags.list List Tags ~40

List unique tags used across the vault.

Input Output Examples

Name	Type	Req	Description
includeCounts	boolean	—	—
sortBy	string	—	—
vaultPath	string	—	—

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

No examples provided.

tags.remove Remove Tags ~36

Remove tags from frontmatter.

Input Output Examples

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

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

No examples provided.

tags.search Search By Tag ~36

Find notes that contain a tag in frontmatter or inline content.

Input Output Examples

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

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

No examples provided.

tags.update Update Tags ~47

Replace or merge a note's frontmatter tags.

Input Output Examples

Name	Type	Req	Description
merge	boolean	—	—
path	string	yes	—
tags	array	yes	—
vaultPath	string	—	—

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

No examples provided.

tasks.create Create Task ~100

Append a task line to a note.

Input Output Examples

Name	Type	Req	Description
content	string	yes	—
createdDate	string	—	—
doneDate	string	—	—
dueDate	string	—	—
filePath	string	yes	—
priority	string	—	—
recurrence	string	—	—
scheduledDate	string	—	—
startDate	string	—	—
status	string	—	—
vaultPath	string	—	—

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

No examples provided.

tasks.search Search Tasks ~96

Search Tasks-plugin style markdown tasks across the vault.

Input Output Examples

Name	Type	Req	Description
dueAfter	string	—	—
dueBefore	string	—	—
dueWithinDays	integer	—	—
hasRecurrence	boolean	—	—
limit	integer	—	—
priority	string	—	—
sortBy	string	—	—
status	string	—	—
tag	string	—	—
vaultPath	string	—	—

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

No examples provided.

tasks.stats Task Statistics ~24

Get aggregate task statistics for the vault.

Input Output Examples

Name	Type	Req	Description
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

tasks.toggle Toggle Task ~52

Toggle a task complete/incomplete by file and line number.

Input Output Examples

Name	Type	Req	Description
doneDate	string	—	—
lineNumber	integer	yes	—
sourceFile	string	yes	—
vaultPath	string	—	—

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

No examples provided.

tasks.updateMetadata Update Task Metadata ~82

Update task dates, priority, or recurrence in place.

Input Output Examples

Name	Type	Req	Description
dueDate	string	—	—
lineNumber	integer	yes	—
priority	string	—	—
recurrence	string	—	—
scheduledDate	string	—	—
sourceFile	string	yes	—
startDate	string	—	—
vaultPath	string	—	—

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

No examples provided.

templates.createNote Create Note From Template ~48

Create a note from a filesystem template.

Input Output Examples

Name	Type	Req	Description
targetPath	string	yes	—
templatePath	string	yes	—
variables	object	—	—
vaultPath	string	—	—

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

No examples provided.

templates.createNoteTemplater Create Note From Templater ~52

Create a note from a Templater template via the Obsidian API.

Input Output Examples

Name	Type	Req	Description
openFile	boolean	—	—
targetFile	string	yes	—
templateFile	string	yes	—

Structured output declared, but exposes no named fields.

No examples provided.

templates.expand Expand Template ~45

Expand filesystem template variables into content.

Input Output Examples

Name	Type	Req	Description
filename	string	—	—
templatePath	string	yes	—
variables	object	—	—
vaultPath	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

templates.insertTemplater Insert Templater Template ~38

Insert a Templater template into the active note.

Input Output Examples

Name	Type	Req	Description
activeFile	boolean	—	—
templateFile	string	yes	—

Structured output declared, but exposes no named fields.

No examples provided.

templates.list List Templates ~31

List markdown templates in a folder.

Input Output Examples

Name	Type	Req	Description
templateFolder	string	—	—
vaultPath	string	—	—

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

No examples provided.

templates.renderTemplater Render Templater Template ~40

Render a Templater template via the Obsidian API.

Input Output Examples

Name	Type	Req	Description
targetFile	string	—	—
templateFile	string	yes	—

Structured output declared, but exposes no named fields.

No examples provided.

wiki.indexRebuild Rebuild Wiki Index ~63

Regenerate the wiki index.md from the current state of Sources/, Concepts/, and Entities/. Groups entries by category; supports optional per-category counts.

Input Output Examples

Name	Type	Req	Description
includeCounts	boolean	—	—
vaultPath	string	—	—
wikiRoot	string	—	—

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

No examples provided.

wiki.ingest Ingest Source ~169

File a new source into the wiki: create Sources/<slug>.md with canonical frontmatter, append a log entry, and return proposedEdits for index + related concept/entity pages for the LLM to apply via notes.update.

Input Output Examples

Name	Type	Req	Description
author	string	—	—
confidence	string	—	—
content	string	—	—
ingestedAt	string	—	—
relatedConcepts	array	—	—
relatedEntities	array	—	—
slug	string	—	—
sourcePath	string	—	—
sourceType	string	—	—
summary	string	—	—
tags	array	—	—
title	string	yes	—
url	string	—	—
vaultPath	string	—	—
wikiRoot	string	—	—

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

No examples provided.

wiki.init Initialize Wiki ~72

Scaffold the wiki layout: Sources/, Concepts/, Entities/ folders plus seed index.md, log.md, and wiki-schema.md. Idempotent; use force:true to re-seed index/log/schema files.

Input Output Examples

Name	Type	Req	Description
force	boolean	—	—
vaultPath	string	—	—
wikiRoot	string	—	—

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

No examples provided.

wiki.lint Lint Wiki ~68

Health-check the wiki: orphans, broken links, stale sources, missing concept pages, singleton tags, and index.md parity. Read-only; returns grouped findings with totals.

Input Output Examples

Name	Type	Req	Description
staleDays	integer	—	—
vaultPath	string	—	—
wikiRoot	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

wiki.logAppend Append Wiki Log Entry ~92

Append a typed chronological entry to the wiki log using the convention '## [YYYY-MM-DD] <op> | <title>'. Initializes the wiki if needed.

Input Output Examples

Name	Type	Req	Description
body	string	—	—
date	string	—	—
op	string	yes	—
refs	array	—	—
title	string	yes	—
vaultPath	string	—	—
wikiRoot	string	—	—

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

No examples provided.

wiki.query Query Wiki ~72

Rank wiki pages relevant to a topic using filename, alias, tag, summary and body hits. Returns the top pages so the LLM can drill in with notes.read.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	—
topic	string	yes	—
vaultPath	string	—	—
wikiRoot	string	—	—

Structured output declared, but exposes no named fields.

No examples provided.

wiki.summaryMerge Merge Summary Into Concept Or Entity Page ~126

Add a cited section into an existing concept or entity page (or create the page with canonical frontmatter if missing). Bumps 'updated' on existing pages.

Input Output Examples

Name	Type	Req	Description
aliases	array	—	—
citationQuote	string	—	—
citationSource	string	—	—
entityKind	string	—	—
heading	string	—	—
newSection	string	yes	—
pageType	string	—	—
summary	string	—	—
targetPath	string	yes	—
vaultPath	string	—	—
wikiRoot	string	—	—

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

No examples provided.

workspace.activeFile Get Active File ~19

Get the currently active file in Obsidian.

Input Output Examples

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

workspace.closeActiveFile Close Active File ~19

Close the active file in Obsidian.

Input Output Examples

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

workspace.navigateBack Navigate Back ~17

Go back in Obsidian history.

Input Output Examples

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

workspace.navigateForward Navigate Forward ~17

Go forward in Obsidian history.

Input Output Examples

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

workspace.openFile Open File ~33

Open a file in Obsidian.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	—
newPane	boolean	—	—

Structured output declared, but exposes no named fields.

No examples provided.

workspace.toggleEditMode Toggle Edit Mode ~20

Toggle edit/preview mode in Obsidian.

Input Output Examples

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

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