Skip to content
MCP server

Obsidian Vault MCP Server

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

Install
Pricing
Open source
Runs
Locally or Remotely
Version
1.3.3
Listing updated
4 days ago

About Obsidian Vault MCP Server

Obsidian Vault MCP Server is an open-source MCP server for knowledge and memory. It can run locally on your machine or as a hosted remote server.

Install

Run in a terminal

claude mcp add mcp-obsidian-via-rest --env API_KEY='<API_KEY>' --env API_URLS='<API_URLS>' -- npx -y @oleksandrkucherenko/mcp-obsidian

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-obsidian-via-rest": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@oleksandrkucherenko/mcp-obsidian"
      ],
      "env": {
        "API_KEY": "<API_KEY>",
        "API_URLS": "<API_URLS>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • API_KEYObsidian Local REST API keyRequired
  • API_URLSJSON array or semicolon-separated list of Obsidian REST API URLs for failoverRequired
  • API_HOSTObsidian REST API host (legacy single-URL config)
  • API_PORTObsidian REST API port (legacy single-URL config)
  • API_KEYObsidian Local REST API keyRequired
  • API_URLSJSON array or semicolon-separated list of Obsidian REST API URLs for failoverRequired
  • MCP_TRANSPORTSEnabled transports (default: stdio,http)
  • MCP_HTTP_PORTHTTP transport bind port (default: 3000)
  • MCP_HTTP_HOSTHTTP transport bind host (default: 0.0.0.0)
  • MCP_HTTP_TOKENBearer token for HTTP transport authentication
  • API_KEYObsidian Local REST API keyRequired
  • API_URLSJSON array of Obsidian REST API URLs (use host.docker.internal for local Obsidian)Required
  • MCP_TRANSPORTSEnabled transports (default: stdio,http)
  • MCP_HTTP_PORTHTTP transport bind port (default: 3000)
  • MCP_HTTP_TOKENBearer token for HTTP transport authentication
  • API_KEYObsidian Local REST API keyRequired
  • API_URLSJSON array of Obsidian REST API URLs (use host.docker.internal for local Obsidian)Required
  • MCP_TRANSPORTSEnabled transports (default: stdio,http)
  • MCP_HTTP_PORTHTTP transport bind port (default: 3000)
  • MCP_HTTP_TOKENBearer token for HTTP transport authentication

Pricing

Open source

Obsidian Vault MCP Server FAQ

Is Obsidian Vault MCP Server free?

Yes. Obsidian Vault MCP Server is open source, so you can use and self-host it for free.

How do I add Obsidian Vault MCP Server to Claude Code?

Run this command in your terminal: claude mcp add mcp-obsidian-via-rest --env API_KEY='<API_KEY>' --env API_URLS='<API_URLS>' -- npx -y @oleksandrkucherenko/mcp-obsidian

What are the best alternatives to Obsidian Vault MCP Server?

The closest alternatives to Obsidian Vault MCP Server are REA, Codebase Memory, XERJ, Claude Code Ultimate Guide and Nautilus Compass Memory.

Alternatives to Obsidian Vault MCP Server

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools