Obsidian CLI MCP
NPM · @DARIUSCODES/OBSIDIAN-CLI-MCP · SCANNED SEP 20
Local MCP server for Obsidian Desktop via the official Obsidian CLI.
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
- 34 of 112 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency48
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 25 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability77
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 3809 tokens (~90/item across 42 items; 42 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management83
- Stability observed for 25 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage93
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 77% of tool parameters carry a description.Partial
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 3 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 42 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 Obsidian CLI MCP server?
Obsidian CLI MCP runs locally as an npm package, launched with npx -y @dariuscodes/obsidian-cli-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 · @dariuscodes/obsidian-cli-mcp
claude mcp add dariuscorvus-obsidian-cli-mcp -- npx -y @dariuscodes/obsidian-cli-mcp
{
"mcpServers": {
"dariuscorvus-obsidian-cli-mcp": {
"command": "npx",
"args": [
"-y",
"@dariuscodes/obsidian-cli-mcp"
]
}
}
} {
"servers": {
"dariuscorvus-obsidian-cli-mcp": {
"command": "npx",
"args": [
"-y",
"@dariuscodes/obsidian-cli-mcp"
]
}
}
} codex mcp add dariuscorvus-obsidian-cli-mcp -- npx -y @dariuscodes/obsidian-cli-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"dariuscorvus-obsidian-cli-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"@dariuscodes/obsidian-cli-mcp"
],
"enabled": true
}
}
} openclaw mcp add dariuscorvus-obsidian-cli-mcp --command npx --arg -y --arg @dariuscodes/obsidian-cli-mcp
mcp_servers:
dariuscorvus-obsidian-cli-mcp:
command: "npx"
args: ["-y", "@dariuscodes/obsidian-cli-mcp"] {
"McpServers": {
"dariuscorvus-obsidian-cli-mcp": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"@dariuscodes/obsidian-cli-mcp"
]
}
}
} assistant mcp add dariuscorvus-obsidian-cli-mcp -t stdio -c npx -a -y @dariuscodes/obsidian-cli-mcp
{
"mcpServers": {
"dariuscorvus-obsidian-cli-mcp": {
"command": "npx",
"args": [
"-y",
"@dariuscodes/obsidian-cli-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 77 to 80. That category is still filling its 30-day observation window: 23 days of observed history at the previous scan, 24 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 70 to 73. That category is still filling its 30-day observation window: 21 days of observed history at the previous scan, 22 at this one. The score rises as the window fills, whether or not the server changes.
- 15 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 63 to 67. That category is still filling its 30-day observation window: 19 days of observed history at the previous scan, 20 at this one. The score rises as the window fills, whether or not the server changes.
- 13 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 57 to 60. That category is still filling its 30-day observation window: 17 days of observed history at the previous scan, 18 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 50 to 53. That category is still filling its 30-day observation window: 15 days of observed history at the previous scan, 16 at this one. The score rises as the window fills, whether or not the server changes.
- 9 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.
- 7 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.
- 4 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.
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/@dariuscodes/obsidian-cli-mcp@0.4.1
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 112 packages
| Packages resolved | 112 |
|---|---|
| Stale | 34 |
| 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 →
attachment_embed Import and embed attachment ~199
Semantic alias for note_attach: import an attachment and embed it in a note with the same guards.
| Name | Type | Req | Description |
|---|---|---|---|
| caption | string | – | Optional embed caption, rendered as ![[file|caption]]. |
| collision | string | – | – |
| contextAfter | string | – | Optional exact text immediately after the insertion cursor. |
| contextBefore | string | – | Optional exact text immediately before the insertion cursor. |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| embed | boolean | – | Insert an Obsidian embed after importing the file. |
| folder | string | – | Optional vault-relative destination folder for the imported file. |
| name | string | – | Optional destination filename. |
| note | string | yes | Vault-relative Markdown note to receive the embed. |
| position | object | – | Optional zero-based cursor for the embed insertion. |
| sourcePath | string | yes | Absolute local path to the file being imported. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
attachment_import Import attachment into vault ~114
Semantic alias for file_import for attachment-oriented callers; the same source, size, path, and collision guards apply.
| Name | Type | Req | Description |
|---|---|---|---|
| collision | string | – | Override the configured collision policy for this import. |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| folder | string | – | Optional vault-relative destination folder. |
| name | string | – | Optional destination filename; defaults to the source filename. |
| sourcePath | string | yes | Absolute local path to the file being imported. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
backlinks_get Get backlinks ~33
List notes with native Obsidian backlinks to a vault note.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Vault-relative target note path. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
canvas_add_edge Add Canvas edge ~125
Add one native Canvas edge between existing node IDs; endpoints are validated before writing.
| Name | Type | Req | Description |
|---|---|---|---|
| color | string | – | – |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| fromEnd | string | – | – |
| fromNode | string | yes | – |
| fromSide | string | – | – |
| id | string | – | – |
| label | string | – | – |
| path | string | yes | – |
| toEnd | string | – | – |
| toNode | string | yes | – |
| toSide | string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
canvas_add_node Add Canvas node ~159
Add one native Canvas node by type. Omitted IDs are deterministic from the requested node content.
| Name | Type | Req | Description |
|---|---|---|---|
| background | string | – | – |
| backgroundStyle | string | – | – |
| color | string | – | – |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| file | string | – | – |
| height | integer | – | – |
| id | string | – | – |
| label | string | – | – |
| path | string | yes | – |
| subpath | string | – | – |
| text | string | – | – |
| type | string | yes | – |
| url | string | – | – |
| width | integer | – | – |
| x | integer | – | – |
| y | integer | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
canvas_auto_layout Auto-layout Canvas ~103
Deterministically lay out Canvas nodes using a dependency-free grid or hierarchical graph algorithm.
| Name | Type | Req | Description |
|---|---|---|---|
| algorithm | string | – | – |
| direction | string | – | – |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| path | string | yes | – |
| spacingX | integer | – | – |
| spacingY | integer | – | – |
| startX | integer | – | – |
| startY | integer | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
canvas_create Create Canvas ~110
Create a native Obsidian .canvas file, optionally with initial nodes and edges. Existing files are not overwritten unless overwrite is true.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| edges | array | – | Initial native Canvas edges. |
| nodes | array | – | Initial native Canvas nodes. |
| overwrite | boolean | – | Explicitly allow replacing an existing file. |
| path | string | yes | Vault-relative destination path ending in .canvas. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
canvas_open Open Canvas ~66
Open a native Obsidian .canvas file through the existing Obsidian CLI file-opening function.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| path | string | yes | Vault-relative path ending in .canvas. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
canvas_read Read Canvas ~40
Read and validate a native Obsidian .canvas file, returning structured nodes and edges.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Vault-relative path ending in .canvas. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
canvas_remove Remove Canvas items ~90
Remove explicitly named node and/or edge IDs. Removing a node also removes every incident edge deterministically.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| edgeIds | array | – | Edge IDs to remove. |
| nodeIds | array | – | Node IDs to remove. |
| path | string | yes | Vault-relative path ending in .canvas. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
canvas_upsert_edges Upsert Canvas edges ~85
Add or partially update native Canvas edges by stable ID. Existing unaddressed edges are preserved and endpoints must reference nodes.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| edges | array | yes | Edge patches keyed by stable id. |
| path | string | yes | Vault-relative path ending in .canvas. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
canvas_upsert_nodes Upsert Canvas nodes ~88
Add or partially update native Canvas nodes by stable ID. Existing nodes, edges, top-level fields, and unknown node fields are preserved.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| nodes | array | yes | Node patches keyed by stable id. |
| path | string | yes | Vault-relative path ending in .canvas. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
daily_append Append to daily note ~61
Append Markdown to today's daily note.
| Name | Type | Req | Description |
|---|---|---|---|
| content | string | yes | Markdown to append. |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| inline | boolean | – | Append without a leading newline. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
daily_open Open daily note ~42
Open today's daily note (creating it if needed).
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
file_delete Delete vault file ~63
Delete one regular vault file. Requires confirm=true; dryRun can preview without confirmation.
| Name | Type | Req | Description |
|---|---|---|---|
| confirm | boolean | – | – |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
file_import Import file into vault ~126
Copy a local file from a configured import root into the vault. Destination names are collision-safe by default; source roots, size, destination policy, and dryRun are enforced.
| Name | Type | Req | Description |
|---|---|---|---|
| collision | string | – | Override the configured collision policy for this import. |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| folder | string | – | Optional vault-relative destination folder. |
| name | string | – | Optional destination filename; defaults to the source filename. |
| sourcePath | string | yes | Absolute local path to the file being imported. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
file_move Move vault file ~68
Move a regular vault file to another vault-relative path with explicit collision policy.
| Name | Type | Req | Description |
|---|---|---|---|
| collision | string | – | – |
| destination | string | yes | – |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
file_read_binary_metadata Read binary file metadata ~37
Read MIME type, byte size, SHA-256, and supported image dimensions for a vault file.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
file_rename Rename vault file ~67
Rename a vault file in its current folder with collision-safe naming.
| Name | Type | Req | Description |
|---|---|---|---|
| collision | string | – | – |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| name | string | yes | – |
| path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
folder_create Create folder ~59
Create a folder (and any missing intermediate folders) in the vault.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| path | string | yes | Vault-relative folder path to create. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
note_append Append to note ~102
Append Markdown to a note, optionally under a specific heading.
| Name | Type | Req | Description |
|---|---|---|---|
| content | string | yes | Markdown to append. |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| heading | string | – | If set, append to the end of this heading's section. |
| inline | boolean | – | Append without a leading newline (plain append only). |
| path | string | yes | Vault-relative path to the note. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
note_attach Import and attach file to note ~218
Import a local file into the vault and optionally insert a relative Obsidian embed into a note. The imported file is retained if the note insertion fails, with its recovery path in the error.
| Name | Type | Req | Description |
|---|---|---|---|
| caption | string | – | Optional embed caption, rendered as ![[file|caption]]. |
| collision | string | – | – |
| contextAfter | string | – | Optional exact text immediately after the insertion cursor. |
| contextBefore | string | – | Optional exact text immediately before the insertion cursor. |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| embed | boolean | – | Insert an Obsidian embed after importing the file. |
| folder | string | – | Optional vault-relative destination folder for the imported file. |
| name | string | – | Optional destination filename. |
| note | string | yes | Vault-relative Markdown note to receive the embed. |
| position | object | – | Optional zero-based cursor for the embed insertion. |
| sourcePath | string | yes | Absolute local path to the file being imported. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
note_create Create note ~144
Create a new note, optionally in a folder, from a template, with initial content and frontmatter.
| Name | Type | Req | Description |
|---|---|---|---|
| content | string | – | Initial Markdown content. |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| folder | string | – | Destination folder (vault-relative). Defaults to vault root. |
| frontmatter | object | – | Frontmatter keys to stamp on the new note. |
| name | string | yes | Note name (a '.md' extension is added if missing). |
| overwrite | boolean | – | Overwrite if the note already exists. |
| template | string | – | Obsidian template name to apply. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
note_delete Delete note ~64
Delete a note. Honors the configured delete.mode (trash by default, or permanent).
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| path | string | yes | Vault-relative path of the note to delete. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
note_diff Diff note versions ~66
Show a note's version history, or diff two versions. Omit from/to to list available versions.
| Name | Type | Req | Description |
|---|---|---|---|
| file | string | yes | Vault-relative path to the note. |
| from | integer | – | Version number to diff from. |
| to | integer | – | Version number to diff to. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
note_insert Insert note text ~130
Compatibility alias for note_insert_at with the same cursor and context guards.
| Name | Type | Req | Description |
|---|---|---|---|
| contextAfter | string | – | Optional exact text immediately after the cursor; rejects stale positions. |
| contextBefore | string | – | Optional exact text immediately before the cursor; rejects stale positions. |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| path | string | yes | Vault-relative path to the note. |
| position | object | yes | Insertion cursor (zero-based line/ch). |
| text | string | yes | Text to insert at the cursor; may contain newlines. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
note_insert_at Insert text at note cursor ~143
Insert text at a zero-based UTF-16 line/ch cursor in a vault note. Optional surrounding context guards reject stale cursor positions.
| Name | Type | Req | Description |
|---|---|---|---|
| contextAfter | string | – | Optional exact text immediately after the cursor; rejects stale positions. |
| contextBefore | string | – | Optional exact text immediately before the cursor; rejects stale positions. |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| path | string | yes | Vault-relative path to the note. |
| position | object | yes | Insertion cursor (zero-based line/ch). |
| text | string | yes | Text to insert at the cursor; may contain newlines. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
note_list List notes ~77
List files in the vault, optionally filtered by folder and extension.
| Name | Type | Req | Description |
|---|---|---|---|
| ext | string | – | Restrict to a file extension, e.g. 'md'. |
| folder | string | – | Restrict to a folder (vault-relative). |
| limit | integer | – | Max number of files to return. |
| sort | string | – | Sort order. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
note_move Move note ~73
Move a note to another folder or path. Links are preserved.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| from | string | yes | Vault-relative path of the note to move. |
| to | string | yes | Destination folder or vault-relative path. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
note_read Read note ~41
Read the full Markdown contents of a note by its vault-relative path.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Vault-relative path, e.g. 'Projects/Apollo.md'. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
note_rename Rename note ~80
Rename a note in place (new name). Backlinks are rewritten automatically.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| from | string | yes | Vault-relative path of the note to rename. |
| to | string | yes | New note name (basename, '.md' optional). |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
note_replace Replace note text ~125
Compatibility alias for note_replace_range with the same positional and expected-text guards.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| end | object | yes | Exclusive end position (zero-based line/ch). |
| expected | string | – | Optional exact guard: the current text in the range must match this value. |
| path | string | yes | Vault-relative path to the note. |
| start | object | yes | Inclusive start position (zero-based line/ch). |
| text | string | yes | Replacement text; may contain newlines. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
note_replace_range Replace note text range ~140
Replace a half-open text range in a vault note using zero-based UTF-16 line/ch positions. An optional expected value guards against stale reads.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| end | object | yes | Exclusive end position (zero-based line/ch). |
| expected | string | – | Optional exact guard: the current text in the range must match this value. |
| path | string | yes | Vault-relative path to the note. |
| start | object | yes | Inclusive start position (zero-based line/ch). |
| text | string | yes | Replacement text; may contain newlines. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
note_set_frontmatter Set note frontmatter ~88
Patch a note's YAML frontmatter via processFrontMatter (never a raw rewrite). A null value removes a key.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| patch | object | yes | Keys to set; a null value deletes the key. |
| path | string | yes | Vault-relative path to the note. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
note_transition Transition note state ~98
Move a note to a new lifecycle state, validated against a configured workflow. Sets the workflow's frontmatter property if the transition is allowed.
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| path | string | yes | Vault-relative path to the note. |
| to | string | yes | Target state. |
| workflow | string | – | Workflow name (required only if several are configured). |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
outlinks_get Get outgoing links ~50
List native Obsidian wikilinks outgoing from a vault note.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Vault-relative note path. |
| total | boolean | – | Ask the native CLI for a total-only result. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
task_create Create task ~105
Create a Markdown checkbox task in a note, optionally under a heading.
| Name | Type | Req | Description |
|---|---|---|---|
| checked | boolean | – | Create the task as completed. |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| heading | string | – | Optional Markdown heading section to append under. |
| indent | integer | – | Number of leading spaces. |
| note | string | yes | Vault-relative note receiving the task. |
| text | string | yes | Task text. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
task_update Update task ~119
Update one Markdown task at a zero-based line number. The optional expected line is an exact stale-read guard.
| Name | Type | Req | Description |
|---|---|---|---|
| checked | boolean | – | New completion state. |
| dryRun | boolean | – | Preview the change without applying it: returns the planned action and the exact CLI command. |
| expected | string | – | Exact current task line; rejects stale updates when it differs. |
| line | integer | yes | Zero-based line number of the task. |
| note | string | yes | Vault-relative note containing the task. |
| text | string | – | New task text. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
tasks_list List tasks ~54
List tasks (checkboxes) in the vault. Scope to the whole vault, the daily note, or the active note.
| Name | Type | Req | Description |
|---|---|---|---|
| filter | string | – | Task completion filter. |
| scope | string | – | Which notes to scan. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
unresolved_links List unresolved links ~20
List unresolved (broken) wikilinks across the vault.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
vault_search Search vault ~118
Full-text search across the vault, returning matching note paths. Optional filters (tag, frontmatter type/status) are combined with the query via Obsidian search operators.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max number of files to return. |
| query | string | – | Text to search for. |
| status | string | – | Restrict to a frontmatter 'status' value. |
| tag | string | – | Restrict to a tag (with or without leading #). |
| type | string | – | Restrict to a frontmatter 'type' value. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
vault_tags List tags ~19
List all tags in the vault with their occurrence counts.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | Optional tool-specific structured result data. |
| text | string | yes | Human-readable result text. |
No examples provided.
What is the Obsidian CLI MCP server?
Obsidian CLI MCP is listed in the public MCP registry as io.github.dariuscorvus/obsidian-cli-mcp. Local MCP server for Obsidian Desktop via the official Obsidian CLI. This page covers its npm package (@dariuscodes/obsidian-cli-mcp).
Is the Obsidian CLI MCP server safe to use?
Obsidian CLI MCP scores 82 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. 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 Obsidian CLI MCP server expose?
Obsidian CLI MCP exposes 42 tools: note_read, vault_search, note_list, vault_tags, unresolved_links, and 37 more. Their descriptions and schemas cost roughly 3,809 tokens of context every time the server is loaded.
Is the Obsidian CLI MCP server still maintained?
Obsidian CLI MCP 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 Obsidian CLI MCP server under?
Obsidian CLI MCP declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.