← Index

Obsidian Vault MCP Server

io.github.OleksandrKucherenko/mcp-obsidian-via-rest·v1.3.3·Search
Quality Score
95
/100

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

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "command": "npx",
      "args": [
        "-y",
        "@oleksandrkucherenko/mcp-obsidian"
      ],
      "env": {
        "API_KEY": "<your-api_key>",
        "API_URLS": "<api_urls>",
        "API_HOST": "<api_host>",
        "API_PORT": "<api_port>",
        "MCP_TRANSPORTS": "stdio,http",
        "MCP_HTTP_PORT": "3000",
        "MCP_HTTP_HOST": "<mcp_http_host>",
        "MCP_HTTP_TOKEN": "<your-mcp_http_token>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "command": "npx",
      "args": [
        "-y",
        "@oleksandrkucherenko/mcp-obsidian"
      ],
      "env": {
        "API_KEY": "<your-api_key>",
        "API_URLS": "<api_urls>",
        "API_HOST": "<api_host>",
        "API_PORT": "<api_port>",
        "MCP_TRANSPORTS": "stdio,http",
        "MCP_HTTP_PORT": "3000",
        "MCP_HTTP_HOST": "<mcp_http_host>",
        "MCP_HTTP_TOKEN": "<your-mcp_http_token>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @oleksandrkucherenko/mcp-obsidian
Claude Desktop (Docker)
{
  "mcpServers": {
    "mcp-obsidian-via-rest": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/oleksandrkucherenko/obsidian-mcp:1.3.3"
      ],
      "env": {
        "API_KEY": "<your-api_key>",
        "API_URLS": "<api_urls>",
        "API_HOST": "<api_host>",
        "API_PORT": "<api_port>",
        "MCP_TRANSPORTS": "stdio,http",
        "MCP_HTTP_PORT": "3000",
        "MCP_HTTP_HOST": "<mcp_http_host>",
        "MCP_HTTP_TOKEN": "<your-mcp_http_token>"
      }
    }
  }
}
§02  Environment variables
API_KEY
requiredsecret

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)

API_KEY
requiredsecret

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

API_KEY
requiredsecret

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

API_KEY
requiredsecret

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

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