obsidian-local-mcp

A local MCP server that wraps the Obsidian CLI, giving AI assistants like Claude direct access to your Obsidian vault. Allows editing in the middle of docs.

Requirements

• Obsidian desktop app installed (v1.8+ with CLI support)
• Node.js 18+
• macOS, Windows, or Linux

Setup

git clone https://github.com/MatthewSuazo/obsidian-local-mcp.git
cd obsidian-local-mcp
npm install

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian-cli": {
      "command": "node",
      "args": ["/path/to/obsidian-local-mcp/server.js"],
      "env": {
        "OBSIDIAN_VAULT": "Your Vault Name"
      }
    }
  }
}

Set OBSIDIAN_VAULT to the name of the vault you want to target. Set OBSIDIAN_CLI_PATH to override the Obsidian binary location if it's not in the default path for your OS.

Tools

| Tool | Description | |------|-------------| | read | Read note contents by name or path | | append | Append content to a note | | prepend | Prepend content to a note | | create | Create a new note (with optional template) | | move | Move or rename a file | | delete | Delete a file (trash or permanent) | | search | Search vault text with line context | | property_set | Set a frontmatter property | | property_read | Read a frontmatter property | | daily_read | Read today's daily note | | daily_append | Append to today's daily note | | replace | Find and replace text in a note (exact, regex, replace-all) | | search_context | Context-aware search returning surrounding content | | files | List files in the vault or a specific folder | | folders | List folders in the vault | | open | Open a file in the Obsidian UI | | eval | Execute JavaScript inside the Obsidian runtime | | command | Execute any registered Obsidian command by ID | | insert_after | Insert content after a matched string in a note |

License

MIT