MCP Server

io.github.afable702/vault-mcp-tools MCP Server

Name: io.github.afable702/vault-mcp-tools MCP Server
Author: io.github.afable702

io.github.afable702/vault-mcp-tools

Repository Registry

What is the io.github.afable702/vault-mcp-tools MCP server?

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

How to install io.github.afable702/vault-mcp-tools

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

OBSIDIAN_VAULT_PATH
required
Absolute path to the Obsidian vault root directory
OBSIDIAN_REST_TOKEN
secret
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_TOKEN
secret
Bearer token for HTTP transport authentication

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "vault-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "vault-mcp-tools"
      ],
      "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>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "vault-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "vault-mcp-tools"
      ],
      "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>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "vault-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "vault-mcp-tools"
      ],
      "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>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "vault-mcp-tools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "vault-mcp-tools"
      ],
      "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>"
      }
    }
  }
}

Claude Code

claude mcp add vault-mcp-tools --env OBSIDIAN_VAULT_PATH=<YOUR_OBSIDIAN_VAULT_PATH> --env OBSIDIAN_REST_TOKEN=<YOUR_OBSIDIAN_REST_TOKEN> --env OBSIDIAN_REST_PORT=<YOUR_OBSIDIAN_REST_PORT> --env OBSIDIAN_TRANSPORT=<YOUR_OBSIDIAN_TRANSPORT> --env OBSIDIAN_HTTP_PORT=<YOUR_OBSIDIAN_HTTP_PORT> --env OBSIDIAN_HTTP_AUTH_TOKEN=<YOUR_OBSIDIAN_HTTP_AUTH_TOKEN> -- npx -y vault-mcp-tools