SERVER

Obsidian Semantic Search

Rank #20,334

io.github.DalecB/obsidian-semantic-mcp

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

3 versions

1 GitHub stars

by dalecb (1 servers)View repository ↗Claim this server

First listed

May 29, 2026

Last publish date

Jun 3, 2026

OVERVIEW

Obsidian Semantic Search is a Model Context Protocol (MCP) server published by dalecb. It ranks #20,334 of 132,046 servers tracked on MCP Toplist, and its repository has 1 GitHub stars. Obsidian Semantic Search is listed across 3 registries — Official MCP, PulseMCP and Glama, with 3 tracked versions. It was first listed on May 29, 2026 and most recently updated on Jun 3, 2026.

STANDING

#20,334of 132,046 tracked serversTop 25%

Ranks ahead of 111,712 of 132,046 servers on MCP Toplist.

CONNECT

Use Obsidian Semantic Search

API keyNeeds credentials

Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.

npm package

claude mcp add obsidian-semantic-mcp -e "OBSIDIAN_VAULT_ROOT=<your OBSIDIAN_VAULT_ROOT>" -e "OBSIDIAN_SEMANTIC_MCP_HOME=<your OBSIDIAN_SEMANTIC_MCP_HOME>" -e "OBSIDIAN_EMBED_MODEL=<your OBSIDIAN_EMBED_MODEL>" -e "OLLAMA_BASE_URL=<your OLLAMA_BASE_URL>" -e "OBSIDIAN_SEMANTIC_STARTUP_INDEX=<your OBSIDIAN_SEMANTIC_STARTUP_INDEX>" -e "OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE=<your OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE>" -e "OBSIDIAN_SEMANTIC_EXCLUDE=<your OBSIDIAN_SEMANTIC_EXCLUDE>" -e "OBSIDIAN_SEMANTIC_SENSITIVE_PATHS=<your OBSIDIAN_SEMANTIC_SENSITIVE_PATHS>" -- npx -y @dalecb/obsidian-semantic-mcp

Replace each placeholder with your own value before saving.

npm package

[mcp_servers.obsidian-semantic-mcp]
command = "npx"
args = ["-y", "@dalecb/obsidian-semantic-mcp"]

[mcp_servers.obsidian-semantic-mcp.env]
OBSIDIAN_VAULT_ROOT = "<your OBSIDIAN_VAULT_ROOT>"
OBSIDIAN_SEMANTIC_MCP_HOME = "<your OBSIDIAN_SEMANTIC_MCP_HOME>"
OBSIDIAN_EMBED_MODEL = "<your OBSIDIAN_EMBED_MODEL>"
OLLAMA_BASE_URL = "<your OLLAMA_BASE_URL>"
OBSIDIAN_SEMANTIC_STARTUP_INDEX = "<your OBSIDIAN_SEMANTIC_STARTUP_INDEX>"
OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE = "<your OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE>"
OBSIDIAN_SEMANTIC_EXCLUDE = "<your OBSIDIAN_SEMANTIC_EXCLUDE>"
OBSIDIAN_SEMANTIC_SENSITIVE_PATHS = "<your OBSIDIAN_SEMANTIC_SENSITIVE_PATHS>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "obsidian-semantic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dalecb/obsidian-semantic-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_ROOT": "<your OBSIDIAN_VAULT_ROOT>",
        "OBSIDIAN_SEMANTIC_MCP_HOME": "<your OBSIDIAN_SEMANTIC_MCP_HOME>",
        "OBSIDIAN_EMBED_MODEL": "<your OBSIDIAN_EMBED_MODEL>",
        "OLLAMA_BASE_URL": "<your OLLAMA_BASE_URL>",
        "OBSIDIAN_SEMANTIC_STARTUP_INDEX": "<your OBSIDIAN_SEMANTIC_STARTUP_INDEX>",
        "OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE": "<your OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE>",
        "OBSIDIAN_SEMANTIC_EXCLUDE": "<your OBSIDIAN_SEMANTIC_EXCLUDE>",
        "OBSIDIAN_SEMANTIC_SENSITIVE_PATHS": "<your OBSIDIAN_SEMANTIC_SENSITIVE_PATHS>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "obsidian-semantic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dalecb/obsidian-semantic-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_ROOT": "<your OBSIDIAN_VAULT_ROOT>",
        "OBSIDIAN_SEMANTIC_MCP_HOME": "<your OBSIDIAN_SEMANTIC_MCP_HOME>",
        "OBSIDIAN_EMBED_MODEL": "<your OBSIDIAN_EMBED_MODEL>",
        "OLLAMA_BASE_URL": "<your OLLAMA_BASE_URL>",
        "OBSIDIAN_SEMANTIC_STARTUP_INDEX": "<your OBSIDIAN_SEMANTIC_STARTUP_INDEX>",
        "OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE": "<your OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE>",
        "OBSIDIAN_SEMANTIC_EXCLUDE": "<your OBSIDIAN_SEMANTIC_EXCLUDE>",
        "OBSIDIAN_SEMANTIC_SENSITIVE_PATHS": "<your OBSIDIAN_SEMANTIC_SENSITIVE_PATHS>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

npm package

{
  "servers": {
    "obsidian-semantic-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dalecb/obsidian-semantic-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_ROOT": "<your OBSIDIAN_VAULT_ROOT>",
        "OBSIDIAN_SEMANTIC_MCP_HOME": "<your OBSIDIAN_SEMANTIC_MCP_HOME>",
        "OBSIDIAN_EMBED_MODEL": "<your OBSIDIAN_EMBED_MODEL>",
        "OLLAMA_BASE_URL": "<your OLLAMA_BASE_URL>",
        "OBSIDIAN_SEMANTIC_STARTUP_INDEX": "<your OBSIDIAN_SEMANTIC_STARTUP_INDEX>",
        "OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE": "<your OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE>",
        "OBSIDIAN_SEMANTIC_EXCLUDE": "<your OBSIDIAN_SEMANTIC_EXCLUDE>",
        "OBSIDIAN_SEMANTIC_SENSITIVE_PATHS": "<your OBSIDIAN_SEMANTIC_SENSITIVE_PATHS>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "obsidian-semantic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dalecb/obsidian-semantic-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_ROOT": "<your OBSIDIAN_VAULT_ROOT>",
        "OBSIDIAN_SEMANTIC_MCP_HOME": "<your OBSIDIAN_SEMANTIC_MCP_HOME>",
        "OBSIDIAN_EMBED_MODEL": "<your OBSIDIAN_EMBED_MODEL>",
        "OLLAMA_BASE_URL": "<your OLLAMA_BASE_URL>",
        "OBSIDIAN_SEMANTIC_STARTUP_INDEX": "<your OBSIDIAN_SEMANTIC_STARTUP_INDEX>",
        "OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE": "<your OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE>",
        "OBSIDIAN_SEMANTIC_EXCLUDE": "<your OBSIDIAN_SEMANTIC_EXCLUDE>",
        "OBSIDIAN_SEMANTIC_SENSITIVE_PATHS": "<your OBSIDIAN_SEMANTIC_SENSITIVE_PATHS>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "obsidian-semantic-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dalecb/obsidian-semantic-mcp"
      ],
      "env": {
        "OBSIDIAN_VAULT_ROOT": "<your OBSIDIAN_VAULT_ROOT>",
        "OBSIDIAN_SEMANTIC_MCP_HOME": "<your OBSIDIAN_SEMANTIC_MCP_HOME>",
        "OBSIDIAN_EMBED_MODEL": "<your OBSIDIAN_EMBED_MODEL>",
        "OLLAMA_BASE_URL": "<your OLLAMA_BASE_URL>",
        "OBSIDIAN_SEMANTIC_STARTUP_INDEX": "<your OBSIDIAN_SEMANTIC_STARTUP_INDEX>",
        "OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE": "<your OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE>",
        "OBSIDIAN_SEMANTIC_EXCLUDE": "<your OBSIDIAN_SEMANTIC_EXCLUDE>",
        "OBSIDIAN_SEMANTIC_SENSITIVE_PATHS": "<your OBSIDIAN_SEMANTIC_SENSITIVE_PATHS>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

Markdown

[![MCP Toplist](https://mcptoplist.com/badge/io.github.DalecB%2Fobsidian-semantic-mcp.svg)](https://mcptoplist.com/server/io.github.DalecB%2Fobsidian-semantic-mcp)

HTML

<a href="https://mcptoplist.com/server/io.github.DalecB%2Fobsidian-semantic-mcp"><img src="https://mcptoplist.com/badge/io.github.DalecB%2Fobsidian-semantic-mcp.svg" alt="MCP Toplist: Top 25% of 132,046" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

REGISTRIES

Listed on 3 registries

PulseMCP

Official MCP

Glama

ORGANIZATION

dalecb

Organization

dalecb

Servers in org

Versions across org

VERSIONS

Available versions (3)

Version	Published
0.2.1	Jun 3, 2026
0.2.0	Jun 3, 2026
0.1.1	May 29, 2026

FAQ

Frequently asked questions

Who maintains Obsidian Semantic Search?: Obsidian Semantic Search is maintained by dalecb, which publishes 1 MCP server (3 total versions) tracked on MCP Toplist.
Is Obsidian Semantic Search listed on the Official MCP Registry?: Yes — Obsidian Semantic Search is listed on the Official MCP Registry, alongside PulseMCP and Glama.
How many versions does Obsidian Semantic Search have?: MCP Toplist tracks 3 versions of Obsidian Semantic Search, most recently published on Jun 3, 2026.
Where can I find the source code for Obsidian Semantic Search?: The source code for Obsidian Semantic Search is hosted at github.com/dalecb/obsidian-semantic-mcp.

Used in projects

Do you run this server?

Add to a project

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE

All MCP Servers Official MCP Servers GitHub MCP Servers Best MCP Servers Most Active MCP Servers New MCP Servers Best New MCP Servers