obsidian-cli-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OBSIDIAN_VAULT | Yes | Vault name this instance targets (injected as vault= on every call). | |
| OBSIDIAN_TIMEOUT | No | Per-command subprocess timeout (seconds). | 30 |
| OBSIDIAN_CLI_PATH | No | Path to the CLI binary if it isn't on PATH. | obsidian |
| OBSIDIAN_GUARD_TTL | No | Seconds to cache a successful vault-guard check. | 5 |
| OBSIDIAN_LOG_LEVEL | No | Log level (logs go to stderr). | INFO |
| OBSIDIAN_VERIFY_READS | No | Run the vault guard before reads too (not just writes). | true |
| OBSIDIAN_ALLOW_PERMANENT_DELETE | No | Allow delete_note(permanent=True) to bypass trash. | false |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| read_noteA | Read a note's full Markdown contents. Specify the note by |
| search_vaultA | Search the vault for text and return matching files (JSON). Set |
| list_filesC | List files in the vault, optionally filtered by |
| list_foldersA | List folders in the vault, optionally under a parent |
| note_infoB | Show metadata for a note (size, dates, counts). Defaults to the active note. |
| list_backlinksC | List notes that link to the target note (JSON). |
| list_tagsC | List tags in the vault, or for a specific note (JSON). |
| list_tasksB | List tasks across the vault or a note (JSON). Filter with |
| list_propertiesB | List frontmatter properties for the vault or a specific note (JSON). |
| read_propertyB | Read a single frontmatter property |
| vault_infoA | Show info about the configured vault (name, path, file/folder counts, size). |
| list_vaultsA | List all Obsidian vaults known to this machine, with their paths. Useful for discovering the exact vault name to put in OBSIDIAN_VAULT. This is a machine-level query, so it is not scoped to the configured vault. |
| create_noteA | Create a new note. Use |
| add_to_noteA | Append or prepend
|
| set_propertyC | Set a frontmatter property
|
| remove_propertyC | Remove a frontmatter property |
| move_noteC | Move a note to a destination folder or path ( |
| rename_noteB | Rename a note to a new |
| delete_noteA | Delete a note (moves it to trash by default — recoverable).
|
| update_taskA | Update a task's status. Identify the task by |
| run_obsidianA | Run any Obsidian CLI command not covered by a dedicated tool (power users). Pass the Disruptive commands (restart, reload, eval, devtools, plugins:restrict) and
all |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/digster/obsidian-cli-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server