Skip to content
Agentmart
Submit a tool

Obsidian CLI MCP

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

Connector by dariuscorvus · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/dariuscorvus-obsidian-cli-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
12 read · 24 write · 3 delete
Secrets
None asked for
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 39

Read from the source code; the running server may list different tools.

Read 12 · Look things up without changing anything.

  • backlinks_get
  • canvas_read
  • file_read_binary_metadata
  • note_diff
  • note_list
  • note_read
  • outlinks_get
  • tasks_list
  • unresolved_links
  • vault_batch
  • vault_search
  • vault_tags

Write 24 · Create, change, send or run things.

  • canvas_add_edge
  • canvas_add_node
  • canvas_auto_layout
  • canvas_create
  • canvas_open
  • canvas_upsert_edges
  • canvas_upsert_nodes
  • daily_append
  • daily_open
  • file_import
  • file_move
  • file_rename
Show 12 more tools
  • folder_create
  • note_append
  • note_attach
  • note_create
  • note_insert_at
  • note_move
  • note_rename
  • note_replace_range
  • note_set_frontmatter
  • note_transition
  • task_create
  • task_update

Delete 3 · Delete, drop, revoke or wipe things.

  • canvas_remove
  • file_delete
  • note_delete

Tools (39)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • backlinks_getGet backlinksread-only

    List notes with native Obsidian backlinks to a vault note.

  • canvas_add_edgeAdd Canvas edge

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

  • canvas_add_nodeAdd Canvas node

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

  • canvas_auto_layoutAuto-layout Canvas

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

  • canvas_createCreate Canvas

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

  • canvas_openOpen Canvas

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

  • canvas_readRead Canvasread-only

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

  • canvas_removeRemove Canvas itemscan change or delete data

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

  • canvas_upsert_edgesUpsert Canvas edges

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

  • canvas_upsert_nodesUpsert Canvas nodes

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

  • daily_appendAppend to daily note

    Append Markdown to today's daily note.

  • daily_openOpen daily note

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

  • file_deleteDelete vault filecan change or delete data

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

  • file_importImport 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.

  • file_moveMove vault file

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

Show 24 more tools
  • file_read_binary_metadataRead binary file metadataread-only

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

  • file_renameRename vault file

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

  • folder_createCreate folder

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

  • note_appendAppend to note

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

  • note_attachImport 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.

  • note_createCreate note

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

  • note_deleteDelete notecan change or delete data

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

  • note_diffDiff note versionsread-only

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

  • note_insert_atInsert 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.

  • note_listList notesread-only

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

  • note_moveMove note

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

  • note_readRead noteread-only

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

  • note_renameRename note

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

  • note_replace_rangeReplace 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.

  • note_set_frontmatterSet note frontmatter

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

  • note_transitionTransition 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.

  • outlinks_getGet outgoing linksread-only

    List native Obsidian wikilinks outgoing from a vault note.

  • task_createCreate task

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

  • task_updateUpdate task

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

  • tasks_listList tasksread-only

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

  • unresolved_linksList unresolved linksread-only

    List unresolved (broken) wikilinks across the vault.

  • vault_batchBatch vault operationsread-only

    Run enabled read tools and preview enabled mutations in one dependency-aware batch. Mutations are accepted only with args.dryRun=true; no batch operation writes or autocommits.

  • vault_searchSearch vaultread-only

    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.

  • vault_tagsList tagsread-only

    List all tags in the vault with their occurrence counts.

Signals

Stars
0
Forks
0
Open issues
1
Weekly downloads
13
Last commit
Aug 26, 2026 (2 months ago)
Last release
Aug 26, 2026 (2 months ago)
Last package publish
Aug 26, 2026 (2 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.dariuscorvus/obsidian-cli-mcp
Version
0.4.1
Auth
No auth
Packages
npm @dariuscodes/obsidian-cli-mcp
License
MIT
Repository
github.com/DariusCorvus/obsidian-cli-mcp
First seen
Oct 24, 2026
Last checked
Oct 25, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

Obsidian CLI MCP. Agent Mart. https://agentmart.dev/connectors/dariuscorvus-obsidian-cli-mcp (last updated 2026-10-25)