Obsidian Vault MCP
CommunityMCP server by luffysolution-svg · updated · ★ 94
Local Zotero, MinerU, Obsidian literature workflow with transactional Analysis notes. Obsidian Vault MCP is a community project by luffysolution-svg, not verified by a company domain.
Last commit 72 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, 94 stars, original repository
No risky patterns in the files we checked
What you need
| Setting | Needed | What it is |
|---|---|---|
OBSIDIAN_Environment variable | Required | Absolute path to the Obsidian vault, or auto when the client project is inside it. |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install Obsidian Vault MCP
Built from the published package, never by AIclaude mcp add obsidian-vault-mcp -e OBSIDIAN_VAULT_PATH=YOUR_OBSIDIAN_VAULT_PATH -- uvx zotero-obsidian-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"obsidian-vault-mcp": {
"command": "uvx",
"args": [
"zotero-obsidian-mcp"
],
"env": {
"OBSIDIAN_VAULT_PATH": "YOUR_OBSIDIAN_VAULT_PATH"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"obsidian-vault-mcp": {
"command": "uvx",
"args": [
"zotero-obsidian-mcp"
],
"env": {
"OBSIDIAN_VAULT_PATH": "YOUR_OBSIDIAN_VAULT_PATH"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"obsidian-vault-mcp": {
"command": "uvx",
"args": [
"zotero-obsidian-mcp"
],
"env": {
"OBSIDIAN_VAULT_PATH": "YOUR_OBSIDIAN_VAULT_PATH"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add obsidian-vault-mcp --env OBSIDIAN_VAULT_PATH=YOUR_OBSIDIAN_VAULT_PATH -- uvx zotero-obsidian-mcp{
"mcpServers": {
"obsidian-vault-mcp": {
"command": "uvx",
"args": [
"zotero-obsidian-mcp"
],
"env": {
"OBSIDIAN_VAULT_PATH": "YOUR_OBSIDIAN_VAULT_PATH"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add obsidian-vault-mcp uvx zotero-obsidian-mcpGemini 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 obsidian-vault-mcp block.
Weekly newsletter
Like Obsidian Vault MCP? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Security check
ANo download-and-run commands, hidden instructions or signs of sending keys out were found.
Checked automatically: README.md. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to Obsidian Vault MCP
All alternatives →Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.
Structured visual plans and PR recaps with diagrams, prototypes, annotations, and sharing
Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.
Make 3D games in Unity Engine with AI. MCP Server + Plugin for Unity Editor and Unity games.
Agent skill that generates beautiful HTML pages for diagrams, diff reviews, plan reviews, slide decks, and data tables
Obsidian Vault MCP: common questions
How do I install Obsidian Vault MCP?
In Claude Code run claude mcp add obsidian-vault-mcp -e OBSIDIAN_VAULT_PATH=YOUR_OBSIDIAN_VAULT_PATH -- uvx zotero-obsidian-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is Obsidian Vault MCP the official server?
Obsidian Vault MCP is a community project by luffysolution-svg, not verified by a company domain.
Is Obsidian Vault MCP free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is Obsidian Vault MCP safe to use?
It scores 73 of 100. Grades: maintenance B, licence A, quality B. 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 Obsidian Vault MCP?
Similar MCP servers: GitDiagram, draw.io, Agent-Native Plan, Figma-Context-MCP.
Does Obsidian Vault MCP 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.
