Skip to content
MCP server

Obsidian Semantic Search

Read-only semantic search MCP server for Obsidian vaults using local Ollama embeddings.

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

About Obsidian Semantic Search

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

Install

Run in a terminal

claude mcp add obsidian-semantic-mcp --env OBSIDIAN_VAULT_ROOT='<OBSIDIAN_VAULT_ROOT>' -- npx -y @dalecb/obsidian-semantic-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-semantic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dalecb/obsidian-semantic-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_ROOT": "<OBSIDIAN_VAULT_ROOT>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "obsidian-semantic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dalecb/obsidian-semantic-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_ROOT": "<OBSIDIAN_VAULT_ROOT>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "obsidian-semantic-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dalecb/obsidian-semantic-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_ROOT": "<OBSIDIAN_VAULT_ROOT>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "obsidian-semantic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dalecb/obsidian-semantic-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_ROOT": "<OBSIDIAN_VAULT_ROOT>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "obsidian-semantic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dalecb/obsidian-semantic-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_ROOT": "<OBSIDIAN_VAULT_ROOT>"
      }
    }
  }
}

Configuration

  • OBSIDIAN_VAULT_ROOTAbsolute path to the local Obsidian vault.Required
  • OBSIDIAN_SEMANTIC_MCP_HOMEDirectory for the external SQLite index, logs, and cache.
  • OBSIDIAN_EMBED_MODELOllama embedding model name. Defaults to bge-m3.
  • OLLAMA_BASE_URLOllama API base URL. Defaults to http://localhost:11434.
  • OBSIDIAN_SEMANTIC_STARTUP_INDEXSet to true to run incremental indexing when the server starts.
  • OBSIDIAN_SEMANTIC_ALLOW_SENSITIVESet to true to allow include_sensitive tool calls.
  • OBSIDIAN_SEMANTIC_EXCLUDEComma- or newline-separated folders to always exclude from indexing, search, and read.
  • OBSIDIAN_SEMANTIC_SENSITIVE_PATHSComma- or newline-separated folders treated as sensitive (blocked unless unlocked). Defaults to 08_PersonalInfo/.

Pricing

Open source

Obsidian Semantic Search FAQ

Is Obsidian Semantic Search free?

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

How do I add Obsidian Semantic Search to Claude Code?

Run this command in your terminal: claude mcp add obsidian-semantic-mcp --env OBSIDIAN_VAULT_ROOT='<OBSIDIAN_VAULT_ROOT>' -- npx -y @dalecb/obsidian-semantic-mcp

What are the best alternatives to Obsidian Semantic Search?

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

Alternatives to Obsidian Semantic Search

  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