How do I install the freshvault mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `FRESHVAULT_VAULT`, `FRESHVAULT_EMBED_URL`, `FRESHVAULT_EMBED_KEY`, `FRESHVAULT_OLLAMA_URL` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Freshvault MCP Server

Local semantic search over your Obsidian vault - always fresh, never reindex.

Local serverstdioPython

What is the Freshvault MCP Server?

Local semantic search over your Obsidian vault - always fresh, never reindex.

The short version

Every other vault-search MCP makes you re-run an index command, babysit a watch terminal, or click "Update Index" in a web UI. freshvault watches your vault from inside the MCP server: edit a note, and Claude sees it seconds later. Automatically. Forever.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
search_notes	semantic search + optional folder / tags / modified_after / modified_before scoping; exact-title lookups boosted
get_note_context	full note + its backlinks/outlinks from the vault link graph (path-traversal safe)
index_status	freshness report: notes/chunks, excluded count, last sync, watcher state

How to install the Freshvault MCP Server

{
  "mcpServers": {
    "freshvault": {
      "command": "npx",
      "args": ["-y", "freshvault"],
      "env": {
        "FRESHVAULT_VAULT": "your-value",
        "FRESHVAULT_EMBED_URL": "your-value",
        "FRESHVAULT_EMBED_KEY": "your-value",
        "FRESHVAULT_OLLAMA_URL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Variable	Description	Required
FRESHVAULT_VAULT	Configuration value read at startup.	Optional
FRESHVAULT_EMBED_URL	Endpoint or connection string the server talks to.	Yes
FRESHVAULT_EMBED_KEY	Credential the server authenticates with.	Yes
FRESHVAULT_OLLAMA_URL	Endpoint or connection string the server talks to.	Yes

Example prompts to try

“Use Freshvault to Incremental.”
“Use Freshvault to Multi.”
“Use Freshvault to Transactional.”

Frequently asked questions

Local semantic search over your Obsidian vault - always fresh, never reindex. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.