Obsidian MCP Server

An MCP server that lets Claude (and other MCP clients) read, write, search, and manage an Obsidian vault as a native tool. Local filesystem access only, no cloud sync.

Tools

All paths are relative to the vault root. The .md extension is optional. Paths are validated to stay inside the vault (no directory traversal).

Related MCP server: Obsidian RAG MCP Server

Setup

npm install
npm run build

The vault location is set with the OBSIDIAN_VAULT_PATH environment variable. If unset, it defaults to ~/Obsidian.

Configure in an MCP client

Add to your client's MCP config (example for a stdio client):

{
  "mcpServers": {
    "obsidian": {
      "command": "node",
      "args": ["/path/to/obsidian-mcp-server/dist/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

Develop

npm run dev        # run from source with tsx
npm run typecheck  # type-check without emitting
npm run inspect    # launch the MCP Inspector against the server

Roadmap

• Semantic/vector search (embed notes, query by meaning)

• Dataview query passthrough

• Template-aware note creation

• Backlink graph traversal

License

MIT