Obsidian Semantic Search MCP Server

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

Local serverstdio

What is the Obsidian Semantic Search MCP Server?

Obsidian Semantic Search is an MCP integration. Read-only semantic search MCP server for Obsidian vaults using local Ollama embeddings.

Packages and local setup

The published npm package is @dalecb/obsidian-semantic-mcp, version 0.2.1. Its declared MCP transport is stdio.

The package declares OBSIDIAN_VAULT_ROOT (required): Absolute path to the local Obsidian vault.; OBSIDIAN_SEMANTIC_MCP_HOME: Directory for the external SQLite index, logs, and cache.; OBSIDIAN_EMBED_MODEL: Ollama embedding model name. Defaults to bge-m3.; OLLAMA_BASE_URL: Ollama API base URL. Defaults to http://localhost:11434.; OBSIDIAN_SEMANTIC_STARTUP_INDEX: Set to true to run incremental indexing when the server starts.; OBSIDIAN_SEMANTIC_ALLOW_SENSITIVE: Set to true to allow include_sensitive tool calls.; OBSIDIAN_SEMANTIC_EXCLUDE: Comma- or newline-separated folders to always exclude from indexing, search, and read.; OBSIDIAN_SEMANTIC_SENSITIVE_PATHS: Comma- or newline-separated folders treated as sensitive (blocked unless unlocked). Defaults to 08_PersonalInfo/..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 0.2.1 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related productivity & project management MCP servers for tools that cover the same kind of work.

Configuration

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