English Français العربية

io.github.afable702/vault-mcp-tools

Official registry Search and web

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

Source code

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package vault-mcp-tools
Claude Code 
claude mcp add vault-mcp-tools -e 'OBSIDIAN_VAULT_PATH=<OBSIDIAN_VAULT_PATH>' -e 'OBSIDIAN_REST_TOKEN=<your obsidian_rest_token>' -e 'OBSIDIAN_REST_PORT=<OBSIDIAN_REST_PORT>' -e 'OBSIDIAN_TRANSPORT=<OBSIDIAN_TRANSPORT>' -e 'OBSIDIAN_HTTP_PORT=<OBSIDIAN_HTTP_PORT>' -e 'OBSIDIAN_HTTP_AUTH_TOKEN=<your obsidian_http_auth_token>' -- npx -y vault-mcp-tools@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "vault-mcp-tools": {
            "command": "npx",
            "args": [
                "-y",
                "vault-mcp-tools@1.0.1"
            ],
            "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>"
            }
        }
    }
}

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

Frequently asked questions

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

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

How do I install io.github.afable702/vault-mcp-tools?

It runs on your machine. In Claude Code: claude mcp add vault-mcp-tools -e 'OBSIDIAN_VAULT_PATH=<OBSIDIAN_VAULT_PATH>' -e 'OBSIDIAN_REST_TOKEN=<your obsidian_rest_token>' -e 'OBSIDIAN_REST_PORT=<OBSIDIAN_REST_PORT>' -e 'OBSIDIAN_TRANSPORT=<OBSIDIAN_TRANSPORT>' -e 'OBSIDIAN_HTTP_PORT=<OBSIDIAN_HTTP_PORT>' -e 'OBSIDIAN_HTTP_AUTH_TOKEN=<your obsidian_http_auth_token>' -- npx -y vault-mcp-tools@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.afable702/vault-mcp-tools need an API key?

Yes. It expects OBSIDIAN_VAULT_PATH, OBSIDIAN_REST_TOKEN, OBSIDIAN_HTTP_AUTH_TOKEN, which you set in its configuration.

Is io.github.afable702/vault-mcp-tools open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.afable702/vault-mcp-tools?

It is published by afable702. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.