Obsidian CLI MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OBSIDIAN_CLI_COMMAND | No | CLI executable name or absolute path. | obsidian |
| OBSIDIAN_LOCKED_VAULT | No | Lock server to specified vault, disallow enumerating all vaults. | |
| OBSIDIAN_DEFAULT_VAULT | No | Default vault to use when tool call doesn't specify vault. | |
| OBSIDIAN_CLI_TIMEOUT_MS | No | Single process execution timeout, range 1-300 seconds. | 30000 |
| OBSIDIAN_CLI_ALLOW_UNSAFE | No | Allow known high-impact commands. | false |
| OBSIDIAN_CLI_EXTRA_COMMANDS | No | Extra command names, comma separated; '*' allows all legal command names. | |
| OBSIDIAN_CLI_MAX_OUTPUT_BYTES | No | Maximum output for a single call, up to 10 MiB. | 1048576 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| obsidian_statusA | Check whether the Obsidian CLI is reachable and return its version. |
| obsidian_helpA | Return official CLI help. Optionally provide a command to inspect its current parameters and flags. |
| obsidian_listC | List vaults, files, or folders known to Obsidian. |
| obsidian_read_noteC | Read a note from an Obsidian vault by vault-relative path. |
| obsidian_write_noteA | Create a note or append/prepend content. Existing files are overwritten only when overwrite=true. |
| obsidian_searchC | Search note contents and return matching files or contextual matches. |
| obsidian_cliA | Advanced escape hatch for official Obsidian CLI features not covered by a dedicated tool. Arguments are passed directly without a shell. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose: listing, reading, writing, searching, status, help, and a generic escape hatch. No overlap or ambiguity.
All tools follow the consistent pattern 'obsidian_<action>' with snake_case, making it predictable for the agent.
Seven tools is well-scoped for an Obsidian CLI wrapper, covering essential operations without being excessive or insufficient.
Covers core CRUD (read, write), search, list, status, and help. Missing explicit delete or rename, but the escape hatch fills gaps.