kObsidian MCP server
Filesystem-first MCP for Obsidian — an LLM-maintained wiki inspired by Karpathy's LLM Wiki.
8 stars119 downloads/wk
Reviews
Write oneNobody has reviewed kObsidian yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
kObsidian tools (92, 28 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
canvas.addEdgeConnect two nodes in a canvas.
canvas.addNodeAdd a text or file node to an Obsidian canvas.
canvas.connectionsGet incoming and outgoing edges for a canvas node.
canvas.createwrite actionCreate a new empty Obsidian canvas (.canvas) file.
canvas.parseParse an Obsidian canvas file.
canvas.removeNodewrite actionRemove a node and its edges from a canvas.
commands.executewrite actionExecute an Obsidian command by ID.
commands.listList all available Obsidian commands.
commands.searchSearch Obsidian commands by ID or name.
dataview.fields.addwrite actionInsert a Dataview field into a note.
dataview.fields.extractExtract scoped Dataview fields from a note.
dataview.fields.removewrite actionRemove a Dataview field from a note.
dataview.fields.searchSearch notes by Dataview field key and optional value.
dataview.index.readRead page, list-item, task, DQL, and DataviewJS metadata from a note.
dataview.js.readExtract fenced dataviewjs blocks from a note without executing them.
dataview.js.updatewrite actionReplace one fenced dataviewjs block source-preservingly.
dataview.listByFolderwrite actionRun a DQL LIST query for a folder.
dataview.listByTagwrite actionRun a DQL LIST query for a tag.
dataview.querywrite actionExecute a Dataview Query Language (DQL) query through the Obsidian API.
dataview.query.readExtract fenced dataview DQL blocks from a note.
dataview.query.updatewrite actionReplace one fenced dataview DQL block source-preservingly.
dataview.tablewrite actionRun a DQL TABLE query.
kanban.addCardAdd a card to a Kanban column.
kanban.moveCardMove a card between Kanban columns.
kanban.parseParse a markdown Kanban board file.
kanban.statsGet card counts and completion rates for a Kanban board.
kanban.toggleCardToggle a Kanban card complete/incomplete.
links.backlinksFind notes that link to a target note.
links.brokenFind broken note links in the vault or a folder.
links.connectionsExplore direct and multi-hop note connections.
links.graphBuild the vault link graph.
links.healthSummarize link density and broken-link metrics.
links.hubsFind notes with many outgoing links.
links.orphanedFind notes with no incoming or outgoing links.
links.outgoingExtract links referenced by a note.
marp.deck.readRead Marp deck frontmatter, slides, directives, and source spans.
marp.frontmatter.updatewrite actionUpdate selected Marp deck frontmatter fields while preserving unrelated source.
marp.slides.listList Marp slides with separator and directive metadata.
marp.slides.readRead one Marp slide source-preservingly.
marp.slides.updatewrite actionReplace one Marp slide body without rewriting neighboring slides.
mermaid.blocks.listList fenced Mermaid blocks in a note or across the vault.
mermaid.blocks.readRead one Mermaid block with source spans, directives, and config metadata.
mermaid.blocks.updatewrite actionReplace one fenced Mermaid block source-preservingly.
notes.appendAppend content to the end of a note.
notes.createwrite actionCreate a new note using filesystem-first behavior.
notes.createFolderwrite actionCreate a folder in the vault.
notes.deletewrite actionDelete a note from the vault.
notes.infoGet note metadata and lightweight statistics without loading the result into a client-specific schema.
notes.insertAfterBlockwrite actionInsert content after a block reference.
notes.insertAfterHeadingwrite actionInsert content immediately after a markdown heading.
notes.listList notes in the vault or a folder.
notes.listFoldersList folders in the vault.
notes.moveMove a note and optionally update links that reference it.
notes.moveFolderMove a folder and optionally update links inside the vault.
notes.readRead a note from the vault with parsed metadata.
notes.searchSearch notes by text with lightweight support for tag: and path: filters.
notes.searchByDateList notes by created or modified date.
notes.updatewrite actionUpdate an existing note, replacing or appending content.
notes.updateFrontmatterwrite actionCreate or update a frontmatter field.
stats.noteGet statistics for a single note.
stats.vaultGet aggregate statistics for the whole vault.
system.versionReturn the running kObsidian server name, version, and host runtime.
tags.addAdd tags to a note frontmatter block.
tags.analyzeExtract frontmatter and inline tags from a note.
tags.listList unique tags used across the vault.
tags.removewrite actionRemove tags from frontmatter.
tags.searchFind notes that contain a tag in frontmatter or inline content.
tags.updatewrite actionReplace or merge a note's frontmatter tags.
tasks.createwrite actionAppend a task line to a note.
tasks.searchSearch Tasks-plugin style markdown tasks across the vault.
tasks.statsGet aggregate task statistics for the vault.
tasks.toggleToggle a task complete/incomplete by file and line number.
tasks.updateMetadatawrite actionUpdate task dates, priority, or recurrence in place.
templates.createNotewrite actionCreate a note from a filesystem template.
templates.createNoteTemplaterwrite actionCreate a note from a Templater template via the Obsidian API.
templates.expandExpand filesystem template variables into content.
templates.insertTemplaterwrite actionInsert a Templater template into the active note.
templates.listList markdown templates in a folder.
templates.renderTemplaterRender a Templater template via the Obsidian API.
wiki.indexRebuildRegenerate the wiki index.md from the current state of Sources/, Concepts/, and Entities/. Groups entries by category; supports optional per-category counts.
wiki.ingestFile 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.
wiki.initScaffold 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.
wiki.lintHealth-check the wiki: orphans, broken links, stale sources, missing concept pages, singleton tags, and index.md parity. Read-only; returns grouped findings with totals.
wiki.logAppendAppend a typed chronological entry to the wiki log using the convention '## [YYYY-MM-DD] <op> | <title>'. Initializes the wiki if needed.
wiki.queryRank 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.
wiki.summaryMergeAdd a cited section into an existing concept or entity page (or create the page with canonical frontmatter if missing). Bumps 'updated' on existing pages.
workspace.activeFileGet the currently active file in Obsidian.
workspace.closeActiveFileClose the active file in Obsidian.
workspace.navigateBackGo back in Obsidian history.
workspace.navigateForwardGo forward in Obsidian history.
workspace.openFileOpen a file in Obsidian.
workspace.toggleEditModeToggle edit/preview mode in Obsidian.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned20/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 18 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- mediumeval / new Function used
exec.evaldist/server/http.js: …eCode, sch); const makeValidate = new Function(`${names_1.default.self}`, `${names_1.de…
Install kObsidian in Claude Code, Cursor or VS Code
Runs npx -y kobsidian-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add kobsidian-mcp -- npx -y kobsidian-mcp
What the publisher says
From the kObsidian repository's README, as published. We do not edit it. Read it on GitHub
kObsidian MCP
Filesystem-first MCP server for Obsidian vaults — with an LLM-Wiki layer on top.
Inspired by Andrej Karpathy's LLM Wiki idea. You curate the sources; the LLM does the bookkeeping.
Install · Quick start · Architecture · LLM Wiki · Tools · Docs
Docs: 简体中文 / 日本語 / 한국어
🧰 The only Obsidian MCP with workspaces. vault.list / vault.select
let an LLM discover and switch between your Obsidian vaults in-session —
no restart, no config edit, no per-tool path threading. Backwards
compatible with OBSIDIANVAULTPATH. Added in v0.3.0.
See docs/WORKSPACES.md.
New in v0.3.7
Configure each vault independently with .kobsidian.json: customize wiki folders, filenames, headings, and the stale-page threshold without sharing one configuration across every vault. notes.edit heading inserts also preserve paragraph spacing and join existing lists cleanly.
Configuration example and upgrade notes.
Why kObsidian
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
kObsidian: common questions
- Is kObsidian MCP server safe?
- Mostly: it is graded B (75/100). Read the kObsidian safety report
- How do I install kObsidian?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does kObsidian need an API key?
- Yes. The registry entry asks for
OBSIDIAN_REST_API_KEY. - Is kObsidian maintained?
- The last commit was 19 days ago (2026-09-09). The latest release is v0.2.1.
- What can I use instead of kObsidian?
- Servers from other publishers that do the same job: Seekstone MCP server, Stellavault MCP server and Obsidian MCP server. Compare all kObsidian alternatives.
Alternatives to kObsidian
Same job from other publishers: the closest match first, then the best rated.
- SeekstoneFilesystem-direct Obsidian MCP server — search and edit your vault with low context-tax.not reviewedGrowingA
- StellavaultLocal-first MCP server: Claude searches, asks & drafts from your Obsidian vault. 21 tools, no keys.not reviewedGrowingA
- ObsidianRead, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP.not reviewedEstablishedA
- Agent-Native ContentOpen-source Obsidian for MDX - edit local docs with agent assistancenot reviewedEstablishedA
- Obsidian Hybrid SearchSearch Obsidian vaults with hybrid full-text, fuzzy, semantic, and graph retrieval.not reviewedEstablishedB