Obsidian Brain

io.github.sweir1/obsidian-brain · Status: active

If you find your own account name here: write informally to German.saas@web.de, stating the identifier concerned. No reason has to be given. How to object

Registry name: io.github.sweir1/obsidian-brain
Package coordinate: npm:obsidian-brain
Version: 1.7.24
Listed in the registry: 2026-05-16
Changed in the registry: 2026-05-16
First seen by tracevero: 2026-08-06
Vendor's website: https://sweir1.github.io/obsidian-brain/

Obsidian MCP server: semantic search, knowledge graph, and vault editing. No plugin required.

Vendor's own description, untranslated and unverified

Evidence for this page: The values on this page come from several collections. Each row therefore states its own origin. What the confidence levels mean

Measured values

Measured values
Credentials required	no Raw declaration – Required secret variables (raw): confirmed absent Raw declaration – Required secret headers (raw): confirmed absent Source: MCP-Register · collected on 2026-08-06 · derived
Execution location	local Raw declaration – Transports (raw): stdio Source: MCP-Register · collected on 2026-08-06 · derived
Path argument present	yes Raw declaration – Path arguments (raw): confirmed absent Raw declaration – Path environment variables (raw): OBSIDIAN_BRAIN_CONFIG_DIR Source: MCP-Register · collected on 2026-08-16 · derived
Repository URL listed	yes Raw declaration – Repository (raw): https://github.com/sweir1/obsidian-brain Source: MCP-Register · collected on 2026-08-06 · derived
Version	1.7.24 Source: MCP-Register · collected on 2026-08-06 · self-declared

Position within the holdings

How many of the 24,507 published entries carry the same measured value. A reference figure, not an assessment.

Credentials requiredno20,303 of 24,507 carry this value (83 %)View these entries
Execution locationlocal12,078 of 24,507 carry this value (49 %)View these entries
Path argument presentyes229 of 24,507 carry this value (0.9 %)View these entries
Repository URL listedyes19,097 of 24,507 carry this value (78 %)View these entries

All 4 values together are carried by 187 of 24,507 entries.

This entry appears in these selections

The source's raw values23

Evidence for this page: The values on this page come from several collections. Each row therefore states its own origin.

Raw values
Environment variables (raw)	VAULT_PATH, DATA_DIR, EMBEDDING_PRESET, EMBEDDING_MODEL, EMBEDDING_PROVIDER, OLLAMA_BASE_URL, OLLAMA_EMBEDDING_DIM, OLLAMA_NUM_CTX, OBSIDIAN_BRAIN_OLLAMA_AUTO_PULL, OBSIDIAN_BRAIN_OLLAMA_BYOM_AUTO_PULL, OBSIDIAN_BRAIN_NO_WATCH, OBSIDIAN_BRAIN_NO_CATCHUP, OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS, OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS, OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS, OBSIDIAN_BRAIN_MAX_CHUNK_TOKENS, OBSIDIAN_BRAIN_CONFIG_DIR, OBSIDIAN_BRAIN_DEBUG, OBSIDIAN_BRAIN_LOG_FORMAT Source: MCP-Register · collected on 2026-08-06 · self-declared
Required secret variables (raw)	confirmed absent Source: MCP-Register · collected on 2026-08-06 · self-declared
Transports (raw)	stdio Source: MCP-Register · collected on 2026-08-06 · self-declared
Path arguments (raw)	confirmed absent Source: MCP-Register · collected on 2026-08-06 · self-declared
Repository (raw)	https://github.com/sweir1/obsidian-brain Source: MCP-Register · collected on 2026-08-06 · self-declared
Package registries (raw)	npm Source: MCP-Register · collected on 2026-08-06 · self-declared
Required secret headers (raw)	confirmed absent Source: MCP-Register · collected on 2026-08-16 · self-declared
Path environment variables (raw)	OBSIDIAN_BRAIN_CONFIG_DIR Source: MCP-Register · collected on 2026-08-16 · self-declared
Remote URLs (raw)	confirmed absent Source: MCP-Register · collected on 2026-08-16 · self-declared
Remote hosts (raw)	confirmed absent Source: MCP-Register · collected on 2026-08-16 · self-declared
Registry status message (raw)	confirmed absent Source: MCP-Register · collected on 2026-08-16 · self-declared
First listed in the registry (raw)	2026-05-16 Source: MCP-Register · collected on 2026-08-16 · self-declared
Last changed in the registry (raw)	2026-05-16 Source: MCP-Register · collected on 2026-08-16 · self-declared
Schema version of the raw record (raw)	https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json Source: MCP-Register · collected on 2026-08-16 · self-declared
Delivery form (raw)	paket Source: MCP-Register · collected on 2026-08-16 · self-declared
Repository platform (raw)	github Source: MCP-Register · collected on 2026-08-16 · self-declared
Repository subfolder (raw)	confirmed absent Source: MCP-Register · collected on 2026-08-16 · self-declared
Package identifiers (raw)	obsidian-brain Source: MCP-Register · collected on 2026-08-16 · self-declared
Package versions (raw)	1.7.24 Source: MCP-Register · collected on 2026-08-16 · self-declared
Runtime hints (raw)	npx Source: MCP-Register · collected on 2026-08-16 · self-declared
Environment variable formats (raw)	filepath, number, string Source: MCP-Register · collected on 2026-08-16 · self-declared
Environment variable descriptions (raw)	DATA_DIR=Where to store the SQLite index + embedding cache. Defaults to $XDG_DATA_HOME/obsidian-brain or ~/.local/share/obsidian-brain. · EMBEDDING_MODEL=Power-user override: any transformers.js checkpoint or Ollama model id. Takes precedence over EMBEDDING_PRESET. Switching auto-reindexes. · EMBEDDING_PRESET=Preset name: english (default, bge-small-en-v1.5), english-fast, english-quality, multilingual, multilingual-quality, multilingual-ollama. Ignored when EMBEDDING_MODEL is set. · EMBEDDING_PROVIDER=Embedding backend. 'transformers' (local, default) or 'ollama' (requires a running Ollama server). · OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS=Graph-wide community-detection (Louvain) debounce for the live watcher, in milliseconds. Louvain is the only expensive op — batching it prevents per-edit CPU spikes. · OBSIDIAN_BRAIN_CONFIG_DIR=Override the per-user config directory where obsidian-brain stores model overrides (`model-overrides.json`) and the user-fetched seed (`seed-models.json`). Default is `$XDG_CONFIG_HOME/obsidian-brain` on macOS/Linux (or `~/.config/obsidian-brain`) and `%APPDATA%/obsidian-brain` on Windows. Both files survive `npm update obsidian-brain` because they live outside the package. · OBSIDIAN_BRAIN_DEBUG=Set to "1" to print a verbose synchronous startup trace to stderr — every preflight, createContext, server.connect, and shutdown step is logged with a monotonic timestamp. The LAST line before any silent failure tells you exactly which step the server reached. No-op when unset (no overhead). Use to diagnose silent-crash failure modes. · OBSIDIAN_BRAIN_LOG_FORMAT=Set to 'ndjson' for one-JSON-object-per-line stderr output (timestamp + level + message + structured fields). Default is human-readable plain text (`obsidian-brain: <message>`). Useful for piping logs into aggregators (Datadog, Loki, Vector, journald) that index structured fields. · OBSIDIAN_BRAIN_MAX_CHUNK_TOKENS=Override the adaptive chunk-size budget (in tokens). When set, this beats the capacity probed from the model's tokenizer or Ollama /api/show. Use for debugging or for models with stale tokenizer configs. · OBSIDIAN_BRAIN_NO_CATCHUP=Set to '1' to skip the startup catchup reindex pass that picks up edits made while the server was down. The live file watcher still starts (via OBSIDIAN_BRAIN_NO_WATCH=1 to disable that separately), and first-time indexing on an empty DB is unaffected — this knob only governs the post-restart `enqueueBackgroundReindex` walk. · OBSIDIAN_BRAIN_NO_WATCH=Set to '1' to disable the live chokidar file watcher. Useful on SMB/NFS vaults where FSEvents/inotify don't fire reliably — fall back to running `obsidian-brain index` on a schedule (launchd/systemd). · OBSIDIAN_BRAIN_OLLAMA_AUTO_PULL=Auto-pull the configured Ollama model when /api/show returns 404 (model not present). Default ON — choosing an Ollama-backed preset is implicit consent to download its model. Streams /api/pull progress to stderr. Set to '0' to disable auto-pull entirely (master kill-switch) and fall back to the actionable error path (`HTTP 404 — try: ollama pull <model>`). · OBSIDIAN_BRAIN_OLLAMA_BYOM_AUTO_PULL=Opt-in to auto-pull for BYOM (custom EMBEDDING_MODEL) Ollama models OUTSIDE Ollama's official `library/` namespace. Default OFF — third-party models (e.g. `user/custom-fork`, `myregistry.com/team/model`) require this env var to be set to `1` before they will auto-pull, to prevent silent downloads of arbitrary user-named artifacts. Preset-known models (via EMBEDDING_PRESET) and bare model ids in the official library (e.g. `qwen3-embedding:0.6b`, `library/llama3:8b`) continue to auto-pull by default per the existing OBSIDIAN_BRAIN_OLLAMA_AUTO_PULL behavior. · OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS=Per-tool-call timeout in milliseconds. Tools exceeding this return an MCP error instead of hanging. · OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS=Per-file reindex debounce for the live watcher, in milliseconds. · OLLAMA_BASE_URL=Base URL of a local Ollama server. Only used when EMBEDDING_PROVIDER=ollama. · OLLAMA_EMBEDDING_DIM=Override the embedding dimensionality when EMBEDDING_PROVIDER=ollama. If unset, the server probes the model on startup. · OLLAMA_NUM_CTX=Override Ollama's num_ctx for embed requests. Leave UNSET to let obsidian-brain auto-detect via `/api/show`'s `context_length` (e.g. nomic-embed-text=2048, bge-m3=8192, qwen3-embedding:0.6b=32 768). Setting this manually imposes a hard cap and may silently truncate longer inputs — see https://github.com/ollama/ollama/issues/14259. Ollama's own default is 2048 which truncates for any model trained on a larger context. See also https://github.com/ollama/ollama/issues/7008. Fallback when both env is unset AND /api/show is unreachable: 8192. · VAULT_PATH=Absolute path to your Obsidian vault (or any folder of .md files). Source: MCP-Register · collected on 2026-08-16 · self-declared
Icon formats (raw)	confirmed absent Source: MCP-Register · collected on 2026-08-16 · self-declared

Changes

Changes
2026-08-16	Path argument present: false → true
2026-08-16	Last changed in the registry (raw): – → 2026-05-16
2026-08-16	First listed in the registry (raw): – → 2026-05-16
2026-08-16	Registry status message (raw): – → –
2026-08-16	Schema version of the raw record (raw): – → https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json
2026-08-16	Icon formats (raw): – → –
2026-08-16	Environment variable descriptions (raw): – → DATA_DIR=Where to store the SQLite index + embedding cache. Defaults to $XDG_DATA_HOME/obsidian-brain or ~/.local/share/obsidian-brain. · EMBEDDING_MODEL=Power-user override: any transformers.js checkpoint or Ollama model id. Takes precedence over EMBEDDING_PRESET. Switching auto-reindexes. · EMBEDDING_PRESET=Preset name: english (default, bge-small-en-v1.5), english-fast, english-quality, multilingual, multilingual-quality, multilingual-ollama. Ignored when EMBEDDING_MODEL is set. · EMBEDDING_PROVIDER=Embedding backend. 'transformers' (local, default) or 'ollama' (requires a running Ollama server). · OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS=Graph-wide community-detection (Louvain) debounce for the live watcher, in milliseconds. Louvain is the only expensive op — batching it prevents per-edit CPU spikes. · OBSIDIAN_BRAIN_CONFIG_DIR=Override the per-user config directory where obsidian-brain stores model overrides (`model-overrides.json`) and the user-fetched seed (`seed-models.json`). Default is `$XDG_CONFIG_HOME/obsidian-brain` on macOS/Linux (or `~/.config/obsidian-brain`) and `%APPDATA%/obsidian-brain` on Windows. Both files survive `npm update obsidian-brain` because they live outside the package. · OBSIDIAN_BRAIN_DEBUG=Set to "1" to print a verbose synchronous startup trace to stderr — every preflight, createContext, server.connect, and shutdown step is logged with a monotonic timestamp. The LAST line before any silent failure tells you exactly which step the server reached. No-op when unset (no overhead). Use to diagnose silent-crash failure modes. · OBSIDIAN_BRAIN_LOG_FORMAT=Set to 'ndjson' for one-JSON-object-per-line stderr output (timestamp + level + message + structured fields). Default is human-readable plain text (`obsidian-brain: <message>`). Useful for piping logs into aggregators (Datadog, Loki, Vector, journald) that index structured fields. · OBSIDIAN_BRAIN_MAX_CHUNK_TOKENS=Override the adaptive chunk-size budget (in tokens). When set, this beats the capacity probed from the model's tokenizer or Ollama /api/show. Use for debugging or for models with stale tokenizer configs. · OBSIDIAN_BRAIN_NO_CATCHUP=Set to '1' to skip the startup catchup reindex pass that picks up edits made while the server was down. The live file watcher still starts (via OBSIDIAN_BRAIN_NO_WATCH=1 to disable that separately), and first-time indexing on an empty DB is unaffected — this knob only governs the post-restart `enqueueBackgroundReindex` walk. · OBSIDIAN_BRAIN_NO_WATCH=Set to '1' to disable the live chokidar file watcher. Useful on SMB/NFS vaults where FSEvents/inotify don't fire reliably — fall back to running `obsidian-brain index` on a schedule (launchd/systemd). · OBSIDIAN_BRAIN_OLLAMA_AUTO_PULL=Auto-pull the configured Ollama model when /api/show returns 404 (model not present). Default ON — choosing an Ollama-backed preset is implicit consent to download its model. Streams /api/pull progress to stderr. Set to '0' to disable auto-pull entirely (master kill-switch) and fall back to the actionable error path (`HTTP 404 — try: ollama pull <model>`). · OBSIDIAN_BRAIN_OLLAMA_BYOM_AUTO_PULL=Opt-in to auto-pull for BYOM (custom EMBEDDING_MODEL) Ollama models OUTSIDE Ollama's official `library/` namespace. Default OFF — third-party models (e.g. `user/custom-fork`, `myregistry.com/team/model`) require this env var to be set to `1` before they will auto-pull, to prevent silent downloads of arbitrary user-named artifacts. Preset-known models (via EMBEDDING_PRESET) and bare model ids in the official library (e.g. `qwen3-embedding:0.6b`, `library/llama3:8b`) continue to auto-pull by default per the existing OBSIDIAN_BRAIN_OLLAMA_AUTO_PULL behavior. · OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS=Per-tool-call timeout in milliseconds. Tools exceeding this return an MCP error instead of hanging. · OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS=Per-file reindex debounce for the live watcher, in milliseconds. · OLLAMA_BASE_URL=Base URL of a local Ollama server. Only used when EMBEDDING_PROVIDER=ollama. · OLLAMA_EMBEDDING_DIM=Override the embedding dimensionality when EMBEDDING_PROVIDER=ollama. If unset, the server probes the model on startup. · OLLAMA_NUM_CTX=Override Ollama's num_ctx for embed requests. Leave UNSET to let obsidian-brain auto-detect via `/api/show`'s `context_length` (e.g. nomic-embed-text=2048, bge-m3=8192, qwen3-embedding:0.6b=32 768). Setting this manually imposes a hard cap and may silently truncate longer inputs — see https://github.com/ollama/ollama/issues/14259. Ollama's own default is 2048 which truncates for any model trained on a larger context. See also https://github.com/ollama/ollama/issues/7008. Fallback when both env is unset AND /api/show is unreachable: 8192. · VAULT_PATH=Absolute path to your Obsidian vault (or any folder of .md files).
2026-08-16	Environment variable formats (raw): – → filepath, number, string
2026-08-16	Delivery form (raw): – → paket
2026-08-16	Remote hosts (raw): – → –

These are the 10 most recent changes to this entry. Full history

tracevero · https://tracevero.com/mcp/io-github-sweir1-obsidian-brain