Obsidian

36 tools. 15 can modify or destroy data without limits.

1 destructive tool with no built-in limits. Policy required.

Last updated:

15 can modify or destroy data
21 read-only
36 tools total

Community server · catalogue entry verified 30/06/2026

How to control Obsidian ↓

What Obsidian exposes to your agents

Read (21) Write / Execute (14) Destructive / Financial (1)
Critical Risk

The most dangerous Obsidian tools

15 of Obsidian's 36 tools can modify, destroy, or commit something on every call — and an agent calls them with no built-in limits.

How to control Obsidian

PolicyLayer is an MCP gateway — it sits between your AI agents and Obsidian, and nothing reaches the server without passing your rules. These are the rules we recommend:

Deny destructive operations
{
  "obsidian_delete_note": {
    "deny_if": [
      {
        "conditions": [],
        "on_deny": "Blocked by default. Requires approval."
      }
    ]
  }
}

Destructive tools should never be available to autonomous agents without human approval.

Rate limit write operations
{
  "obsidian_append_note": {
    "limits": [
      {
        "counter": "obsidian_append_note_per_hour",
        "window": "hour",
        "max": 30,
        "scope": "grant"
      }
    ]
  }
}

Prevents bulk unintended modifications from agents caught in loops.

Cap read operations
{
  "obsidian_dev_console": {
    "limits": [
      {
        "counter": "obsidian_dev_console_per_minute",
        "window": "minute",
        "max": 60,
        "scope": "grant"
      }
    ]
  }
}

Controls API costs and prevents retry loops from exhausting upstream rate limits.

  1. Create a free account and register Obsidian — nothing to install.
  2. Add these rules — paste them, or build them visually. Tune the limits to your setup.
  3. Point your MCP client (Claude, Cursor, anything) at your gateway URL.
ENFORCE POLICY ON OBSIDIAN →

Instant setup, no code required.

All 36 Obsidian tools

READ 21 tools
Read obsidian_dev_console Returns recent console messages from Obsidian DevTools. Read obsidian_dev_errors Returns recent JS errors from the Obsidian DevTools console. Read obsidian_dev_screenshot Returns a base64-encoded PNG screenshot of the running Obsidian window. Read obsidian_files_with_tag Lists every note tagged with the given tag. Read obsidian_get_backlinks Returns notes that link to the target note. Read obsidian_get_links Returns the outgoing wikilinks from a note. Read obsidian_get_metadata Returns metadata for a note (frontmatter, tags, links, file stats) as JSON. Read obsidian_get_properties Returns the YAML frontmatter properties of a note as JSON. Read obsidian_help Shows the underlying Read obsidian_list_files Lists every note in the vault. Returns JSON by default. Useful as a first step to discover what exists. Read obsidian_list_folders Displays the vault folder structure as a tree. Read obsidian_list_orphans Finds notes that have no incoming wikilinks. Read obsidian_list_plugins Lists installed community + core plugins with enabled state. Read obsidian_list_tags Lists every tag used in the vault, with usage counts. Read obsidian_list_unresolved Finds wikilinks that point to non-existent notes. Read obsidian_read_note Returns the full markdown content of a note. Read obsidian_scan_root Lists every .md file at the vault root with frontmatter and a body preview. Read obsidian_search Full-text search across the vault. Returns matching files. Read obsidian_search_context Full-text search that returns surrounding lines of context for each hit. Read obsidian_topic_stats Returns the persistent topic store for the given vault — every topic the MCP Read obsidian_version Returns the version of the Obsidian CLI binary in use.

Related servers

Other MCP servers with similar tools — same risk classification, starter policies for each.

Questions about Obsidian

Can an AI agent delete data through the Obsidian MCP server? +

Yes. The Obsidian server exposes 1 destructive tools including obsidian_delete_note. These permanently remove resources with no undo. PolicyLayer blocks destructive tools by default so they never reach the upstream server.

How do I prevent bulk modifications through Obsidian? +

The Obsidian server has 10 write tools including obsidian_append_note, obsidian_create_note, obsidian_move_note. Set a rate limit in your policy -- for example, 10 calls per hour prevents an agent from making more than 10 modifications per hour. PolicyLayer enforces this at the gateway, before calls reach Obsidian.

How many tools does the Obsidian MCP server expose? +

36 tools across 3 categories: Destructive, Read, Write. 21 are read-only. 15 can modify, create, or delete data.

How do I enforce a policy on Obsidian? +

Register the Obsidian MCP server in PolicyLayer, apply the suggested rules above (adjust the limits to your use case), and point your AI client at the PolicyLayer proxy URL instead of the server directly. Your agents keep the same tools; PolicyLayer evaluates every call against policy before it executes. Nothing to install, live in minutes.

Enforce policy on every Obsidian tool call.

Deterministic rules across all 36 Obsidian tools. Per-identity grants. Full audit log. Live in minutes. Nothing to install.

Instant setup, no code required.

36 Obsidian tools catalogued and risk-classified — across an index of 43,000+ MCP servers.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.