kObsidian
NPM · KOBSIDIAN-MCP · SCANNED SEP 20
Filesystem-first MCP for Obsidian — an LLM-maintained wiki inspired by Karpathy's LLM Wiki.
Available components
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
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
claude mcp add bezata-kobsidian-mcp -- npx -y kobsidian-mcp
{
"mcpServers": {
"bezata-kobsidian-mcp": {
"command": "npx",
"args": [
"-y",
"kobsidian-mcp"
]
}
}
} {
"servers": {
"bezata-kobsidian-mcp": {
"command": "npx",
"args": [
"-y",
"kobsidian-mcp"
]
}
}
} codex mcp add bezata-kobsidian-mcp -- npx -y kobsidian-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"bezata-kobsidian-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"kobsidian-mcp"
],
"enabled": true
}
}
} openclaw mcp add bezata-kobsidian-mcp --command npx --arg -y --arg kobsidian-mcp
mcp_servers:
bezata-kobsidian-mcp:
command: "npx"
args: ["-y", "kobsidian-mcp"] {
"McpServers": {
"bezata-kobsidian-mcp": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"kobsidian-mcp"
]
}
}
} assistant mcp add bezata-kobsidian-mcp -t stdio -c npx -a -y kobsidian-mcp
{
"mcpServers": {
"bezata-kobsidian-mcp": {
"command": "npx",
"args": [
"-y",
"kobsidian-mcp"
]
}
}
} 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
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 →
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 →
notes.list List Notes ~39
List notes in the vault or a folder.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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 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 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 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 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.
| 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 schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
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.