mcp-obsidian-cli
CommunityMCP server by stonematt · updated · ★ 2 · 64 downloads a week
Save chat notes from Claude Desktop to your vault — MCP on Obsidian CLI. Keep what matters. mcp-obsidian-cli is a community project by stonematt, not verified by a company domain.
Last commit 9 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, original repository
No risky patterns in the files we checked
What you need
| Setting | Needed | What it is |
|---|---|---|
OBSIDIAN_VAULTEnvironment variable | Optional | Target vault name. If unset or unknown, the server prompts the caller on first tool use, listing the vaults Obsidian knows about. |
OBSIDIAN_CLI_PATHEnvironment variable | Optional | Path to the obsidian-cli binary. Auto-discovered on macOS; set explicitly on Linux/Windows or if the binary is non-standard. Default: obsidian-cli |
OBSIDIAN_TIMEOUT_MSEnvironment variable | Optional | Per-command timeout in milliseconds. Default: 15000 |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install mcp-obsidian-cli
Built from the published package, never by AIclaude mcp add mcp-obsidian-cli -- npx -y mcp-obsidian-cliRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"mcp-obsidian-cli": {
"command": "npx",
"args": [
"-y",
"mcp-obsidian-cli"
]
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"mcp-obsidian-cli": {
"command": "npx",
"args": [
"-y",
"mcp-obsidian-cli"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"mcp-obsidian-cli": {
"command": "npx",
"args": [
"-y",
"mcp-obsidian-cli"
]
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add mcp-obsidian-cli -- npx -y mcp-obsidian-cli{
"mcpServers": {
"mcp-obsidian-cli": {
"command": "npx",
"args": [
"-y",
"mcp-obsidian-cli"
]
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add mcp-obsidian-cli npx -y mcp-obsidian-cliGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the mcp-obsidian-cli block.
Security check
ANo download-and-run commands, hidden instructions or signs of sending keys out were found.
Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to mcp-obsidian-cli
All alternatives →Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
Open-source Obsidian for MDX - edit local docs with agent assistance
A private persistent computer: files and a bash shell that survive between runs.
MCP server for terminal commands, file operations, and process management
Filesystem-first framework for durable backend AI agents that run anywhere.
W3C Web Model Context Protocol (WebMCP) API polyfill. Let AI agents like Claude, ChatGPT, and Gemini interact with your website via document.modelContext.
mcp-obsidian-cli: common questions
How do I install mcp-obsidian-cli?
In Claude Code run claude mcp add mcp-obsidian-cli -- npx -y mcp-obsidian-cli. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is mcp-obsidian-cli the official server?
mcp-obsidian-cli is a community project by stonematt, not verified by a company domain.
Is mcp-obsidian-cli free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is mcp-obsidian-cli safe to use?
It scores 74 of 100. Grades: maintenance A, licence A, quality C. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.
What are alternatives to mcp-obsidian-cli?
Similar MCP servers: mcp-server, Agent-Native Content, Computer, Desktop Commander.
Does mcp-obsidian-cli work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
