Obsidian Vault MCP Server

by phssakaigawa

MCP server for reading and searching an Obsidian vault directly from the filesystem. No Obsidian plugin, no REST API, no running Obsidian required.

0Node.jsstdio

context tax

queued

security

queued

cold start

queued

freshness

Maintained41d ago

Install Obsidian Vault MCP server

claude mcp add obsidian-vault -- npx -y @phssakaigawa/obsidian-vault-mcp

{
  "mcpServers": {
    "obsidian-vault": {
      "command": "npx",
      "args": [
        "-y",
        "@phssakaigawa/obsidian-vault-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "obsidian-vault": {
      "command": "npx",
      "args": [
        "-y",
        "@phssakaigawa/obsidian-vault-mcp"
      ]
    }
  }
}

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

{
  "servers": {
    "obsidian-vault": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@phssakaigawa/obsidian-vault-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "obsidian-vault": {
      "command": "npx",
      "args": [
        "-y",
        "@phssakaigawa/obsidian-vault-mcp"
      ]
    }
  }
}

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

Freshness

Maintained — last maintenance signal 41d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-29 · 41d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
no data · official registry

FAQ

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

Run: claude mcp add obsidian-vault -- npx -y @phssakaigawa/obsidian-vault-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Obsidian Vault require an API key?

No required environment variables are declared in its published metadata.

›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?

No. It was indexed from npm.