← Index

io.github.afable702/vault-mcp-tools

io.github.afable702/vault-mcp-tools·v1.0.1·Search
Quality Score
85
/100

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

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "vault-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "vault-mcp-tools"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<obsidian_vault_path>",
        "OBSIDIAN_REST_TOKEN": "<your-obsidian_rest_token>",
        "OBSIDIAN_REST_PORT": "<obsidian_rest_port>",
        "OBSIDIAN_TRANSPORT": "<obsidian_transport>",
        "OBSIDIAN_HTTP_PORT": "<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": "<obsidian_vault_path>",
        "OBSIDIAN_REST_TOKEN": "<your-obsidian_rest_token>",
        "OBSIDIAN_REST_PORT": "<obsidian_rest_port>",
        "OBSIDIAN_TRANSPORT": "<obsidian_transport>",
        "OBSIDIAN_HTTP_PORT": "<obsidian_http_port>",
        "OBSIDIAN_HTTP_AUTH_TOKEN": "<your-obsidian_http_auth_token>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y vault-mcp-tools
§02  Environment variables
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

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
10
§04  Alternatives in Search