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