MCP Hub › Memory & Knowledge › Obsidian Vault MCP Server

Obsidian Vault MCP Server MCP server

by OleksandrKucherenko · io.github.OleksandrKucherenko/mcp-obsidian-via-rest

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

🧠 Memory & KnowledgeDockernpmv1.3.3
Open in MCP HubGitHub repository ↗Website ↗

How to install Obsidian Vault MCP Server

npm

claude mcp add -e API_KEY=<your-api-key> -e API_URLS=<your-api-urls> mcp-obsidian-via-rest -- npx -y @oleksandrkucherenko/[email protected]

Or add it to your MCP config (Claude Desktop, Cursor, VS Code):

{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "command": "npx",
      "args": [
        "-y",
        "@oleksandrkucherenko/[email protected]"
      ],
      "env": {
        "API_KEY": "<your-api-key>",
        "API_URLS": "<your-api-urls>"
      }
    }
  }
}

Environment variables:
API_KEY (required) – 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)

npm

claude mcp add -e API_KEY=<your-api-key> -e API_URLS=<your-api-urls> mcp-obsidian-via-rest -- npx -y @oleksandrkucherenko/[email protected]

Or add it to your MCP config (Claude Desktop, Cursor, VS Code):

{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "command": "npx",
      "args": [
        "-y",
        "@oleksandrkucherenko/[email protected]"
      ],
      "env": {
        "API_KEY": "<your-api-key>",
        "API_URLS": "<your-api-urls>"
      }
    }
  }
}

Environment variables:
API_KEY (required) – 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 – Bearer token for HTTP transport authentication

Docker

claude mcp add -e API_KEY=<your-api-key> -e API_URLS=<your-api-urls> mcp-obsidian-via-rest -- docker run -i --rm ghcr.io/oleksandrkucherenko/obsidian-mcp:1.3.3

Or add it to your MCP config (Claude Desktop, Cursor, VS Code):

{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/oleksandrkucherenko/obsidian-mcp:1.3.3"
      ],
      "env": {
        "API_KEY": "<your-api-key>",
        "API_URLS": "<your-api-urls>"
      }
    }
  }
}

Environment variables:
API_KEY (required) – 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 – Bearer token for HTTP transport authentication

Docker

claude mcp add -e API_KEY=<your-api-key> -e API_URLS=<your-api-urls> mcp-obsidian-via-rest -- docker run -i --rm docker.io/oleksandrkucherenko/obsidian-mcp:1.3.3

Or add it to your MCP config (Claude Desktop, Cursor, VS Code):

{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/oleksandrkucherenko/obsidian-mcp:1.3.3"
      ],
      "env": {
        "API_KEY": "<your-api-key>",
        "API_URLS": "<your-api-urls>"
      }
    }
  }
}

Environment variables:
API_KEY (required) – 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 – Bearer token for HTTP transport authentication

Replace placeholders in <angle brackets> with your own values. Review what a server can access before you enable it.

Details

Version
1.3.3
Published
2026-01-18
Updated
2026-01-18
Namespace
io.github.OleksandrKucherenko
Source
OleksandrKucherenko/mcp-obsidian-via-rest

Similar memory & knowledge servers