Obsidian Vault MCP Server

by luffysolution-svgio.github.luffysolution-svg/obsidian-vault-mcpv3.0.2

Local Zotero, MinerU, Obsidian literature workflow with transactional Analysis notes.

91Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained2mo ago

Install Obsidian Vault MCP server

claude mcp add zotero-obsidian -e OBSIDIAN_VAULT_PATH='<obsidian-vault-path>' -- uvx zotero-obsidian-mcp serve --transport stdio

{
  "mcpServers": {
    "zotero-obsidian": {
      "command": "uvx",
      "args": [
        "zotero-obsidian-mcp",
        "serve",
        "--transport",
        "stdio"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<obsidian-vault-path>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "zotero-obsidian": {
      "command": "uvx",
      "args": [
        "zotero-obsidian-mcp",
        "serve",
        "--transport",
        "stdio"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<obsidian-vault-path>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "zotero-obsidian": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "zotero-obsidian-mcp",
        "serve",
        "--transport",
        "stdio"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<obsidian-vault-path>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "zotero-obsidian": {
      "command": "uvx",
      "args": [
        "zotero-obsidian-mcp",
        "serve",
        "--transport",
        "stdio"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<obsidian-vault-path>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
OBSIDIAN_VAULT_PATH	yes	—	Absolute path to the Obsidian vault, or auto when the client project is inside it.

Freshness

Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-11 · 2mo ago · GitHub
Latest release
2026-08-11 · 2mo ago · GitHub · v3.0.2
Package published
no data · npm/PyPI
Registry entry updated
2026-08-11 · 2mo ago · official registry · v3.0.2

FAQ

›How do I install the Obsidian Vault MCP server in Claude Code?

Run: claude mcp add zotero-obsidian -e OBSIDIAN_VAULT_PATH='<obsidian-vault-path>' -- uvx zotero-obsidian-mcp serve --transport stdio. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Obsidian Vault require an API key?

Yes. It expects OBSIDIAN_VAULT_PATH.

›Can I use Obsidian Vault as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Obsidian Vault in the official MCP registry?

Yes, as io.github.luffysolution-svg/obsidian-vault-mcp.