Home › Other › Obsidian Vault MCP Server

Obsidian Vault MCP Server

Access Obsidian vaults via Local REST API - read, search, and interact with notes

TypeScript

★ 13 stars Last pushed 2026-04-05 License: MIT

View repository → Website →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 1.3.3)

npx -y @oleksandrkucherenko/[email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "command": "npx",
      "args": [
        "-y",
        "@oleksandrkucherenko/[email protected]"
      ],
      "env": {
        "API_KEY": "<YOUR_VALUE>",
        "API_URLS": "<YOUR_VALUE>",
        "API_HOST": "<YOUR_VALUE>",
        "API_PORT": "<YOUR_VALUE>"
      }
    }
  }
}

API_KEY required secret — Obsidian Local REST API key
API_URLS required — JSON array or semicolon-separated list of Obsidian REST API URLs for failover
API_HOST — Obsidian REST API host (legacy single-URL config)
API_PORT — Obsidian REST API port (legacy single-URL config)

Package (npm 1.3.3)

Package: npm @oleksandrkucherenko/mcp-obsidian

API_KEY required secret — Obsidian Local REST API key
API_URLS required — JSON array or semicolon-separated list of Obsidian REST API URLs for failover
MCP_TRANSPORTS — Enabled transports (default: stdio,http)
MCP_HTTP_PORT — HTTP transport bind port (default: 3000)
MCP_HTTP_HOST — HTTP transport bind host (default: 0.0.0.0)
MCP_HTTP_TOKEN secret — Bearer token for HTTP transport authentication

Package (oci)

Package: oci ghcr.io/oleksandrkucherenko/obsidian-mcp:1.3.3

API_KEY required secret — Obsidian Local REST API key
API_URLS required — JSON array of Obsidian REST API URLs (use host.docker.internal for local Obsidian)
MCP_TRANSPORTS — Enabled transports (default: stdio,http)
MCP_HTTP_PORT — HTTP transport bind port (default: 3000)
MCP_HTTP_TOKEN secret — Bearer token for HTTP transport authentication

Package (oci)

Package: oci docker.io/oleksandrkucherenko/obsidian-mcp:1.3.3

API_KEY required secret — Obsidian Local REST API key
API_URLS required — JSON array of Obsidian REST API URLs (use host.docker.internal for local Obsidian)
MCP_TRANSPORTS — Enabled transports (default: stdio,http)
MCP_HTTP_PORT — HTTP transport bind port (default: 3000)
MCP_HTTP_TOKEN secret — Bearer token for HTTP transport authentication