Skip to content
MCP server

kObsidian

Filesystem-first MCP for Obsidian — an LLM-maintained wiki inspired by Karpathy's LLM…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.2.1
Listing updated
4 days ago

About kObsidian

kObsidian is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Filesystem-first MCP for Obsidian — an LLM-maintained wiki inspired by Karpathy's LLM Wiki.

Install

Run in a terminal

claude mcp add kobsidian-mcp --env OBSIDIAN_VAULT_PATH='<OBSIDIAN_VAULT_PATH>' --env OBSIDIAN_REST_API_KEY='<OBSIDIAN_REST_API_KEY>' -- npx -y kobsidian-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "kobsidian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kobsidian-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_REST_API_KEY": "<OBSIDIAN_REST_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "kobsidian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kobsidian-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_REST_API_KEY": "<OBSIDIAN_REST_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "kobsidian-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kobsidian-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_REST_API_KEY": "<OBSIDIAN_REST_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "kobsidian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kobsidian-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_REST_API_KEY": "<OBSIDIAN_REST_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "kobsidian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kobsidian-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_REST_API_KEY": "<OBSIDIAN_REST_API_KEY>"
      }
    }
  }
}

Configuration

  • OBSIDIAN_VAULT_PATHAbsolute path to the Obsidian vault this server should operate on.Required
  • OBSIDIAN_API_URLBase URL of the Obsidian Local REST API plugin. Only required for workspace.* / commands.* / live dataview.query* tools.
  • OBSIDIAN_API_VERIFY_TLSSet to 'true' if you've trusted the Local REST API's self-signed certificate.
  • OBSIDIAN_REST_API_KEYBearer key for the Obsidian Local REST API plugin (only needed for REST-bridged tools).

Pricing

Open source

kObsidian FAQ

Is kObsidian free?

Yes. kObsidian is open source, so you can use and self-host it for free.

How do I add kObsidian to Claude Code?

Run this command in your terminal: claude mcp add kobsidian-mcp --env OBSIDIAN_VAULT_PATH='<OBSIDIAN_VAULT_PATH>' --env OBSIDIAN_REST_API_KEY='<OBSIDIAN_REST_API_KEY>' -- npx -y kobsidian-mcp

What are the best alternatives to kObsidian?

The closest alternatives to kObsidian are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

Alternatives to kObsidian

  1. 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
  2. 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
  3. 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
  4. 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
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity