Obsidian Cli MCP Server
by stonemattio.github.stonematt/mcp-obsidian-cliv2.1.0
Save chat notes from Claude Desktop to your vault — MCP on Obsidian CLI. Keep what matters.
context tax
queued
security
queued
cold start
queued
freshness
Active32d ago
Install Obsidian Cli MCP server
Install in Claude Code
claude mcp add obsidian-cli -- npx -y mcp-obsidian-cliInstall in Cursor
{
"mcpServers": {
"obsidian-cli": {
"command": "npx",
"args": [
"-y",
"mcp-obsidian-cli"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"obsidian-cli": {
"command": "npx",
"args": [
"-y",
"mcp-obsidian-cli"
]
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"obsidian-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-obsidian-cli"
]
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"obsidian-cli": {
"command": "npx",
"args": [
"-y",
"mcp-obsidian-cli"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| OBSIDIAN_VAULT | — | — | Target vault name. If unset or unknown, the server prompts the caller on first tool use, listing the vaults Obsidian knows about. |
| OBSIDIAN_CLI_PATH | — | — | Path to the obsidian-cli binary. Auto-discovered on macOS; set explicitly on Linux/Windows or if the binary is non-standard. |
| OBSIDIAN_TIMEOUT_MS | — | — | Per-command timeout in milliseconds. |
Freshness
Active — last maintenance signal 32d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-05 · 34d ago · GitHub
Latest release
2026-09-08 · 32d ago · GitHub · v2.1.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-08 · 32d ago · official registry · v2.1.0
FAQ
›How do I install the Obsidian Cli MCP server in Claude Code?
Run: claude mcp add obsidian-cli -- npx -y mcp-obsidian-cli. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Obsidian Cli require an API key?
No required environment variables are declared in its published metadata.
›Can I use Obsidian Cli as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Obsidian Cli in the official MCP registry?
Yes, as io.github.stonematt/mcp-obsidian-cli.
Alternatives to Obsidian Cli
Other notes & knowledge MCP servers.