# Obsidian CLI MCP (npm · @dariuscodes/obsidian-cli-mcp)

Local MCP server for Obsidian Desktop via the official Obsidian CLI.

- Trust score: 82/100 (high trust)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-20

## Components

- npm · `@dariuscodes/obsidian-cli-mcp`: 82/100 (this document), [markdown](https://verifymcp.io/servers/dariuscorvus-obsidian-cli-mcp/dariuscodes-obsidian-cli-mcp.md), [page](https://verifymcp.io/servers/dariuscorvus-obsidian-cli-mcp/dariuscodes-obsidian-cli-mcp)

## Channel facts

- Registry: `npm`
- Package: `@dariuscodes/obsidian-cli-mcp`
- Version: `0.4.1`
- Transport: `stdio`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-20.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 34 of 112 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 25 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 3809 tokens (~90/item across 42 items; 42 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 83/100
  - Stability observed for 25 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 93/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 77% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 3 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 42 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

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

### Claude

```bash
claude mcp add dariuscorvus-obsidian-cli-mcp -- npx -y @dariuscodes/obsidian-cli-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "dariuscorvus-obsidian-cli-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dariuscodes/obsidian-cli-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "dariuscorvus-obsidian-cli-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dariuscodes/obsidian-cli-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add dariuscorvus-obsidian-cli-mcp -- npx -y @dariuscodes/obsidian-cli-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dariuscorvus-obsidian-cli-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@dariuscodes/obsidian-cli-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add dariuscorvus-obsidian-cli-mcp --command npx --arg -y --arg @dariuscodes/obsidian-cli-mcp
```

### Hermes

```yaml
mcp_servers:
  dariuscorvus-obsidian-cli-mcp:
    command: "npx"
    args: ["-y", "@dariuscodes/obsidian-cli-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "dariuscorvus-obsidian-cli-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@dariuscodes/obsidian-cli-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add dariuscorvus-obsidian-cli-mcp -t stdio -c npx -a -y @dariuscodes/obsidian-cli-mcp
```

### Other

```json
{
  "mcpServers": {
    "dariuscorvus-obsidian-cli-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dariuscodes/obsidian-cli-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-19 (score 82, +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.

### 2026-09-17 (score 81, +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.

### 2026-09-15 (score 80, +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.

### 2026-09-13 (score 79, +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.

### 2026-09-11 (score 78, +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.

### 2026-09-09 (score 77, +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.

### 2026-09-07 (score 76, +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.

### 2026-09-04 (score 75, +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.

## MCP tools (42)

### `note_read` (~41 tokens)

Read note

Read the full Markdown contents of a note by its vault-relative path.

Input parameters:

- `path` (string, required): Vault-relative path, e.g. 'Projects/Apollo.md'.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `vault_search` (~118 tokens)

Search vault

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.

Input parameters:

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

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `note_list` (~77 tokens)

List notes

List files in the vault, optionally filtered by folder and extension.

Input parameters:

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

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `vault_tags` (~19 tokens)

List tags

List all tags in the vault with their occurrence counts.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `unresolved_links` (~20 tokens)

List unresolved links

List unresolved (broken) wikilinks across the vault.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `tasks_list` (~54 tokens)

List tasks

List tasks (checkboxes) in the vault. Scope to the whole vault, the daily note, or the active note.

Input parameters:

- `filter` (string): Task completion filter.
- `scope` (string): Which notes to scan.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `note_diff` (~66 tokens)

Diff note versions

Show a note's version history, or diff two versions. Omit from/to to list available versions.

Input parameters:

- `file` (string, required): Vault-relative path to the note.
- `from` (integer): Version number to diff from.
- `to` (integer): Version number to diff to.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `note_create` (~144 tokens)

Create note

Create a new note, optionally in a folder, from a template, with initial content and frontmatter.

Input parameters:

- `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, required): Note name (a '.md' extension is added if missing).
- `overwrite` (boolean): Overwrite if the note already exists.
- `template` (string): Obsidian template name to apply.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `note_append` (~102 tokens)

Append to note

Append Markdown to a note, optionally under a specific heading.

Input parameters:

- `content` (string, required): 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, required): Vault-relative path to the note.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `note_set_frontmatter` (~88 tokens)

Set note frontmatter

Patch a note's YAML frontmatter via processFrontMatter (never a raw rewrite). A null value removes a key.

Input parameters:

- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `patch` (object, required): Keys to set; a null value deletes the key.
- `path` (string, required): Vault-relative path to the note.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `daily_open` (~42 tokens)

Open daily note

Open today's daily note (creating it if needed).

Input parameters:

- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `daily_append` (~61 tokens)

Append to daily note

Append Markdown to today's daily note.

Input parameters:

- `content` (string, required): 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.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `note_replace_range` (~140 tokens)

Replace note text range

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.

Input parameters:

- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `end` (object, required): Exclusive end position (zero-based line/ch).
- `expected` (string): Optional exact guard: the current text in the range must match this value.
- `path` (string, required): Vault-relative path to the note.
- `start` (object, required): Inclusive start position (zero-based line/ch).
- `text` (string, required): Replacement text; may contain newlines.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `note_insert_at` (~143 tokens)

Insert text at note cursor

Insert text at a zero-based UTF-16 line/ch cursor in a vault note. Optional surrounding context guards reject stale cursor positions.

Input parameters:

- `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, required): Vault-relative path to the note.
- `position` (object, required): Insertion cursor (zero-based line/ch).
- `text` (string, required): Text to insert at the cursor; may contain newlines.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `note_replace` (~125 tokens)

Replace note text

Compatibility alias for note_replace_range with the same positional and expected-text guards.

Input parameters:

- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `end` (object, required): Exclusive end position (zero-based line/ch).
- `expected` (string): Optional exact guard: the current text in the range must match this value.
- `path` (string, required): Vault-relative path to the note.
- `start` (object, required): Inclusive start position (zero-based line/ch).
- `text` (string, required): Replacement text; may contain newlines.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `note_insert` (~130 tokens)

Insert note text

Compatibility alias for note_insert_at with the same cursor and context guards.

Input parameters:

- `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, required): Vault-relative path to the note.
- `position` (object, required): Insertion cursor (zero-based line/ch).
- `text` (string, required): Text to insert at the cursor; may contain newlines.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `file_import` (~126 tokens)

Import file into vault

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.

Input parameters:

- `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, required): Absolute local path to the file being imported.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `attachment_import` (~114 tokens)

Import attachment into vault

Semantic alias for file_import for attachment-oriented callers; the same source, size, path, and collision guards apply.

Input parameters:

- `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, required): Absolute local path to the file being imported.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `note_attach` (~218 tokens)

Import and attach file to note

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.

Input parameters:

- `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, required): Vault-relative Markdown note to receive the embed.
- `position` (object): Optional zero-based cursor for the embed insertion.
- `sourcePath` (string, required): Absolute local path to the file being imported.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `attachment_embed` (~199 tokens)

Import and embed attachment

Semantic alias for note_attach: import an attachment and embed it in a note with the same guards.

Input parameters:

- `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, required): Vault-relative Markdown note to receive the embed.
- `position` (object): Optional zero-based cursor for the embed insertion.
- `sourcePath` (string, required): Absolute local path to the file being imported.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `file_move` (~68 tokens)

Move vault file

Move a regular vault file to another vault-relative path with explicit collision policy.

Input parameters:

- `collision` (string)
- `destination` (string, required)
- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `path` (string, required)

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `file_rename` (~67 tokens)

Rename vault file

Rename a vault file in its current folder with collision-safe naming.

Input parameters:

- `collision` (string)
- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `name` (string, required)
- `path` (string, required)

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `file_delete` (~63 tokens)

Delete vault file

Delete one regular vault file. Requires confirm=true; dryRun can preview without confirmation.

Input parameters:

- `confirm` (boolean)
- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `path` (string, required)

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `file_read_binary_metadata` (~37 tokens)

Read binary file metadata

Read MIME type, byte size, SHA-256, and supported image dimensions for a vault file.

Input parameters:

- `path` (string, required)

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `task_create` (~105 tokens)

Create task

Create a Markdown checkbox task in a note, optionally under a heading.

Input parameters:

- `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, required): Vault-relative note receiving the task.
- `text` (string, required): Task text.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `task_update` (~119 tokens)

Update task

Update one Markdown task at a zero-based line number. The optional expected line is an exact stale-read guard.

Input parameters:

- `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, required): Zero-based line number of the task.
- `note` (string, required): Vault-relative note containing the task.
- `text` (string): New task text.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `backlinks_get` (~33 tokens)

Get backlinks

List notes with native Obsidian backlinks to a vault note.

Input parameters:

- `path` (string, required): Vault-relative target note path.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `outlinks_get` (~50 tokens)

Get outgoing links

List native Obsidian wikilinks outgoing from a vault note.

Input parameters:

- `path` (string, required): Vault-relative note path.
- `total` (boolean): Ask the native CLI for a total-only result.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `canvas_add_node` (~159 tokens)

Add Canvas node

Add one native Canvas node by type. Omitted IDs are deterministic from the requested node content.

Input parameters:

- `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, required)
- `subpath` (string)
- `text` (string)
- `type` (string, required)
- `url` (string)
- `width` (integer)
- `x` (integer)
- `y` (integer)

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `canvas_add_edge` (~125 tokens)

Add Canvas edge

Add one native Canvas edge between existing node IDs; endpoints are validated before writing.

Input parameters:

- `color` (string)
- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `fromEnd` (string)
- `fromNode` (string, required)
- `fromSide` (string)
- `id` (string)
- `label` (string)
- `path` (string, required)
- `toEnd` (string)
- `toNode` (string, required)
- `toSide` (string)

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `canvas_auto_layout` (~103 tokens)

Auto-layout Canvas

Deterministically lay out Canvas nodes using a dependency-free grid or hierarchical graph algorithm.

Input parameters:

- `algorithm` (string)
- `direction` (string)
- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `path` (string, required)
- `spacingX` (integer)
- `spacingY` (integer)
- `startX` (integer)
- `startY` (integer)

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `note_rename` (~80 tokens)

Rename note

Rename a note in place (new name). Backlinks are rewritten automatically.

Input parameters:

- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `from` (string, required): Vault-relative path of the note to rename.
- `to` (string, required): New note name (basename, '.md' optional).

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `note_move` (~73 tokens)

Move note

Move a note to another folder or path. Links are preserved.

Input parameters:

- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `from` (string, required): Vault-relative path of the note to move.
- `to` (string, required): Destination folder or vault-relative path.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `folder_create` (~59 tokens)

Create folder

Create a folder (and any missing intermediate folders) in the vault.

Input parameters:

- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `path` (string, required): Vault-relative folder path to create.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `note_delete` (~64 tokens)

Delete note

Delete a note. Honors the configured delete.mode (trash by default, or permanent).

Input parameters:

- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `path` (string, required): Vault-relative path of the note to delete.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `note_transition` (~98 tokens)

Transition note state

Move a note to a new lifecycle state, validated against a configured workflow. Sets the workflow's frontmatter property if the transition is allowed.

Input parameters:

- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `path` (string, required): Vault-relative path to the note.
- `to` (string, required): Target state.
- `workflow` (string): Workflow name (required only if several are configured).

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `canvas_read` (~40 tokens)

Read Canvas

Read and validate a native Obsidian .canvas file, returning structured nodes and edges.

Input parameters:

- `path` (string, required): Vault-relative path ending in .canvas.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `canvas_create` (~110 tokens)

Create Canvas

Create a native Obsidian .canvas file, optionally with initial nodes and edges. Existing files are not overwritten unless overwrite is true.

Input parameters:

- `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, required): Vault-relative destination path ending in .canvas.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `canvas_upsert_nodes` (~88 tokens)

Upsert Canvas nodes

Add or partially update native Canvas nodes by stable ID. Existing nodes, edges, top-level fields, and unknown node fields are preserved.

Input parameters:

- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `nodes` (array, required): Node patches keyed by stable id.
- `path` (string, required): Vault-relative path ending in .canvas.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `canvas_upsert_edges` (~85 tokens)

Upsert Canvas edges

Add or partially update native Canvas edges by stable ID. Existing unaddressed edges are preserved and endpoints must reference nodes.

Input parameters:

- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `edges` (array, required): Edge patches keyed by stable id.
- `path` (string, required): Vault-relative path ending in .canvas.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `canvas_remove` (~90 tokens)

Remove Canvas items

Remove explicitly named node and/or edge IDs. Removing a node also removes every incident edge deterministically.

Input parameters:

- `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, required): Vault-relative path ending in .canvas.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

### `canvas_open` (~66 tokens)

Open Canvas

Open a native Obsidian .canvas file through the existing Obsidian CLI file-opening function.

Input parameters:

- `dryRun` (boolean): Preview the change without applying it: returns the planned action and the exact CLI command.
- `path` (string, required): Vault-relative path ending in .canvas.

Output parameters:

- `data`: Optional tool-specific structured result data.
- `text` (string): Human-readable result text.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/dariuscorvus-obsidian-cli-mcp/dariuscodes-obsidian-cli-mcp#diagnostics

## Score history

- 2026-09-20: 82
- 2026-09-19: 82
- 2026-09-18: 81
- 2026-09-17: 81
- 2026-09-16: 80
- 2026-09-15: 80
- 2026-09-14: 79
- 2026-09-13: 79
- 2026-09-12: 78
- 2026-09-11: 78
- 2026-09-10: 77
- 2026-09-09: 77
- 2026-09-08: 76
- 2026-09-07: 76
- 2026-09-06: 75
- 2026-09-05: 75
- 2026-09-04: 75
- 2026-09-03: 74
- 2026-09-02: 70
- 2026-09-01: 70
- 2026-08-31: 70
- 2026-08-30: 70
- 2026-08-29: 70
- 2026-08-28: 70
- 2026-08-27: 70
- 2026-08-26: 70

## Common questions

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

## Links

- npm package: https://www.npmjs.com/package/@dariuscodes/obsidian-cli-mcp
- Socket report: https://socket.dev/npm/package/@dariuscodes/obsidian-cli-mcp
- Repository: https://github.com/DariusCorvus/obsidian-cli-mcp
- Changelog RSS feed: https://verifymcp.io/servers/dariuscorvus-obsidian-cli-mcp/dariuscodes-obsidian-cli-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/dariuscorvus-obsidian-cli-mcp/dariuscodes-obsidian-cli-mcp.json
- HTML version of this page: https://verifymcp.io/servers/dariuscorvus-obsidian-cli-mcp/dariuscodes-obsidian-cli-mcp