io.github.afable702/vault-mcp-tools

Official

Complete Obsidian vault MCP server. 35 tools: notes, search, graph, tags, canvas.

Manages Obsidian vaults with 35 tools for notes, search, graphs, and tags.

Install

Configuration

Environment variables

OBSIDIAN_VAULT_PATHrequired

Absolute path to the Obsidian vault root directory

OBSIDIAN_REST_TOKENsecret

Bearer token for the Obsidian REST API (enables 3 bonus tools: execute_command, list_commands, open_in_obsidian)

OBSIDIAN_REST_PORT

REST API port (default: 27124)

OBSIDIAN_TRANSPORT

Transport mode: stdio (default) or http

OBSIDIAN_HTTP_PORT

HTTP transport port (default: 3000)

OBSIDIAN_HTTP_AUTH_TOKENsecret

Bearer token for HTTP transport authentication

claude_desktop_config.json

{
  "mcpServers": {
    "vault-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "vault-mcp-tools@1.0.1"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<YOUR_OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_REST_TOKEN": "<YOUR_OBSIDIAN_REST_TOKEN>",
        "OBSIDIAN_REST_PORT": "<YOUR_OBSIDIAN_REST_PORT>",
        "OBSIDIAN_TRANSPORT": "<YOUR_OBSIDIAN_TRANSPORT>",
        "OBSIDIAN_HTTP_PORT": "<YOUR_OBSIDIAN_HTTP_PORT>",
        "OBSIDIAN_HTTP_AUTH_TOKEN": "<YOUR_OBSIDIAN_HTTP_AUTH_TOKEN>"
      }
    }
  }
}