@alexfatalix/obsidian-cli-mcp
v0.1.0
Published
Local MCP server for Obsidian CLI
Maintainers
Readme
Obsidian CLI MCP
Local MCP server for Obsidian CLI.
It runs over stdio and is intended for personal local use with MCP clients such as Codex, Inspector, or other compatible tools.
Requirements
- Obsidian desktop app installed
- Obsidian CLI installed and available as
obsidian - Node.js 18+
Run with npx
npx -y @alexfatalix/obsidian-cli-mcpMCP Config
{
"mcpServers": {
"obsidian": {
"command": "npx",
"args": ["-y", "@alexfatalix/obsidian-cli-mcp"],
"env": {
"OBSIDIAN_VAULT": "My Vault",
"OBSIDIAN_TOOL_MODE": "safe"
}
}
}
}Configuration
OBSIDIAN_VAULT: default vault used for tool callsOBSIDIAN_TOOL_MODE: tool policy modesafe— note-focused subset, defaultfull— all non-developer Obsidian CLI toolsdev— full CLI, including developer tools
OBSIDIAN_CLI: custom path to the Obsidian CLI binaryOBSIDIAN_CLI_TIMEOUT_MS: per-command timeout, default30000OBSIDIAN_CLI_MAX_BUFFER_BYTES: max captured stdout/stderr size, default16777216
Notes
- Tool names match Obsidian CLI command names
:in command names is exposed as.- Example:
daily:appendbecomesdaily.append safemode is recommended for normal use
License
MIT. See LICENSE.
