Obsidian Brain
Rank #6,281io.github.sweir1/obsidian-brain
Obsidian MCP server: semantic search, knowledge graph, and vault editing. No plugin required.
Obsidian Brain is a Model Context Protocol (MCP) server published by sweir1. It ranks #6,281 of 115,460 servers tracked on MCP Toplist, and its repository has 10 GitHub stars. Obsidian Brain is listed across 3 registries — Official MCP, PulseMCP and Glama, with 42 tracked versions. It was first listed on Apr 21, 2026 and most recently updated on May 16, 2026.
Ranks ahead of 109,179 of 115,460 servers on MCP Toplist.
Use Obsidian Brain
Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.
claude mcp add obsidian-brain -e "VAULT_PATH=<your VAULT_PATH>" -e "DATA_DIR=<your DATA_DIR>" -e "EMBEDDING_PRESET=<your EMBEDDING_PRESET>" -e "EMBEDDING_MODEL=<your EMBEDDING_MODEL>" -e "EMBEDDING_PROVIDER=<your EMBEDDING_PROVIDER>" -e "OLLAMA_BASE_URL=<your OLLAMA_BASE_URL>" -e "OLLAMA_EMBEDDING_DIM=<your OLLAMA_EMBEDDING_DIM>" -e "OBSIDIAN_BRAIN_NO_WATCH=<your OBSIDIAN_BRAIN_NO_WATCH>" -e "OBSIDIAN_BRAIN_NO_CATCHUP=<your OBSIDIAN_BRAIN_NO_CATCHUP>" -e "OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS=<your OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS>" -e "OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS=<your OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS>" -e "OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS=<your OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS>" -- npx -y obsidian-brain serverReplace each placeholder with your own value before saving.
[mcp_servers.obsidian-brain]
command = "npx"
args = ["-y", "obsidian-brain", "server"]
[mcp_servers.obsidian-brain.env]
VAULT_PATH = "<your VAULT_PATH>"
DATA_DIR = "<your DATA_DIR>"
EMBEDDING_PRESET = "<your EMBEDDING_PRESET>"
EMBEDDING_MODEL = "<your EMBEDDING_MODEL>"
EMBEDDING_PROVIDER = "<your EMBEDDING_PROVIDER>"
OLLAMA_BASE_URL = "<your OLLAMA_BASE_URL>"
OLLAMA_EMBEDDING_DIM = "<your OLLAMA_EMBEDDING_DIM>"
OBSIDIAN_BRAIN_NO_WATCH = "<your OBSIDIAN_BRAIN_NO_WATCH>"
OBSIDIAN_BRAIN_NO_CATCHUP = "<your OBSIDIAN_BRAIN_NO_CATCHUP>"
OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS = "<your OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS>"
OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS = "<your OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS>"
OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS = "<your OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"obsidian-brain": {
"command": "npx",
"args": [
"-y",
"obsidian-brain",
"server"
],
"env": {
"VAULT_PATH": "<your VAULT_PATH>",
"DATA_DIR": "<your DATA_DIR>",
"EMBEDDING_PRESET": "<your EMBEDDING_PRESET>",
"EMBEDDING_MODEL": "<your EMBEDDING_MODEL>",
"EMBEDDING_PROVIDER": "<your EMBEDDING_PROVIDER>",
"OLLAMA_BASE_URL": "<your OLLAMA_BASE_URL>",
"OLLAMA_EMBEDDING_DIM": "<your OLLAMA_EMBEDDING_DIM>",
"OBSIDIAN_BRAIN_NO_WATCH": "<your OBSIDIAN_BRAIN_NO_WATCH>",
"OBSIDIAN_BRAIN_NO_CATCHUP": "<your OBSIDIAN_BRAIN_NO_CATCHUP>",
"OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS": "<your OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS>",
"OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS": "<your OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS>",
"OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS": "<your OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"obsidian-brain": {
"command": "npx",
"args": [
"-y",
"obsidian-brain",
"server"
],
"env": {
"VAULT_PATH": "<your VAULT_PATH>",
"DATA_DIR": "<your DATA_DIR>",
"EMBEDDING_PRESET": "<your EMBEDDING_PRESET>",
"EMBEDDING_MODEL": "<your EMBEDDING_MODEL>",
"EMBEDDING_PROVIDER": "<your EMBEDDING_PROVIDER>",
"OLLAMA_BASE_URL": "<your OLLAMA_BASE_URL>",
"OLLAMA_EMBEDDING_DIM": "<your OLLAMA_EMBEDDING_DIM>",
"OBSIDIAN_BRAIN_NO_WATCH": "<your OBSIDIAN_BRAIN_NO_WATCH>",
"OBSIDIAN_BRAIN_NO_CATCHUP": "<your OBSIDIAN_BRAIN_NO_CATCHUP>",
"OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS": "<your OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS>",
"OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS": "<your OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS>",
"OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS": "<your OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"obsidian-brain": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"obsidian-brain",
"server"
],
"env": {
"VAULT_PATH": "<your VAULT_PATH>",
"DATA_DIR": "<your DATA_DIR>",
"EMBEDDING_PRESET": "<your EMBEDDING_PRESET>",
"EMBEDDING_MODEL": "<your EMBEDDING_MODEL>",
"EMBEDDING_PROVIDER": "<your EMBEDDING_PROVIDER>",
"OLLAMA_BASE_URL": "<your OLLAMA_BASE_URL>",
"OLLAMA_EMBEDDING_DIM": "<your OLLAMA_EMBEDDING_DIM>",
"OBSIDIAN_BRAIN_NO_WATCH": "<your OBSIDIAN_BRAIN_NO_WATCH>",
"OBSIDIAN_BRAIN_NO_CATCHUP": "<your OBSIDIAN_BRAIN_NO_CATCHUP>",
"OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS": "<your OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS>",
"OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS": "<your OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS>",
"OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS": "<your OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"obsidian-brain": {
"command": "npx",
"args": [
"-y",
"obsidian-brain",
"server"
],
"env": {
"VAULT_PATH": "<your VAULT_PATH>",
"DATA_DIR": "<your DATA_DIR>",
"EMBEDDING_PRESET": "<your EMBEDDING_PRESET>",
"EMBEDDING_MODEL": "<your EMBEDDING_MODEL>",
"EMBEDDING_PROVIDER": "<your EMBEDDING_PROVIDER>",
"OLLAMA_BASE_URL": "<your OLLAMA_BASE_URL>",
"OLLAMA_EMBEDDING_DIM": "<your OLLAMA_EMBEDDING_DIM>",
"OBSIDIAN_BRAIN_NO_WATCH": "<your OBSIDIAN_BRAIN_NO_WATCH>",
"OBSIDIAN_BRAIN_NO_CATCHUP": "<your OBSIDIAN_BRAIN_NO_CATCHUP>",
"OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS": "<your OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS>",
"OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS": "<your OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS>",
"OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS": "<your OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"obsidian-brain": {
"command": "npx",
"args": [
"-y",
"obsidian-brain",
"server"
],
"env": {
"VAULT_PATH": "<your VAULT_PATH>",
"DATA_DIR": "<your DATA_DIR>",
"EMBEDDING_PRESET": "<your EMBEDDING_PRESET>",
"EMBEDDING_MODEL": "<your EMBEDDING_MODEL>",
"EMBEDDING_PROVIDER": "<your EMBEDDING_PROVIDER>",
"OLLAMA_BASE_URL": "<your OLLAMA_BASE_URL>",
"OLLAMA_EMBEDDING_DIM": "<your OLLAMA_EMBEDDING_DIM>",
"OBSIDIAN_BRAIN_NO_WATCH": "<your OBSIDIAN_BRAIN_NO_WATCH>",
"OBSIDIAN_BRAIN_NO_CATCHUP": "<your OBSIDIAN_BRAIN_NO_CATCHUP>",
"OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS": "<your OBSIDIAN_BRAIN_WATCH_DEBOUNCE_MS>",
"OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS": "<your OBSIDIAN_BRAIN_COMMUNITY_DEBOUNCE_MS>",
"OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS": "<your OBSIDIAN_BRAIN_TOOL_TIMEOUT_MS>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.sweir1%2Fobsidian-brain)<a href="https://mcptoplist.com/server/io.github.sweir1%2Fobsidian-brain"><img src="https://mcptoplist.com/badge/io.github.sweir1%2Fobsidian-brain.svg" alt="MCP Toplist: Top 10% of 115,460" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 2 registries (1 delisted)
sweir1
Other servers by sweir1
View all sweir1 servers →Available versions (42)
| Version | Published |
|---|---|
| 1.7.24 | May 16, 2026 |
| 1.7.23 | May 16, 2026 |
| 1.7.22 | May 15, 2026 |
| 1.7.21 | Apr 30, 2026 |
| 1.7.20 | Apr 27, 2026 |
| 1.7.19 | Apr 26, 2026 |
| 1.7.17 | Apr 26, 2026 |
| 1.7.15 | Apr 26, 2026 |
| 1.7.13 | Apr 26, 2026 |
| 1.7.12 | Apr 26, 2026 |
| 1.7.11 | Apr 26, 2026 |
| 1.7.2 | Apr 25, 2026 |
| 1.7.1 | Apr 24, 2026 |
| 1.7.0 | Apr 24, 2026 |
| 1.6.22 | Apr 24, 2026 |
| 1.6.21 | Apr 24, 2026 |
| 1.6.19 | Apr 24, 2026 |
| 1.6.18 | Apr 24, 2026 |
| 1.6.15 | Apr 24, 2026 |
| 1.6.14 | Apr 24, 2026 |
| 1.6.13 | Apr 24, 2026 |
| 1.6.12 | Apr 23, 2026 |
| 1.6.11 | Apr 23, 2026 |
| 1.6.10 | Apr 23, 2026 |
| 1.6.9 | Apr 23, 2026 |
| 1.6.8 | Apr 23, 2026 |
| 1.6.7 | Apr 23, 2026 |
| 1.6.6 | Apr 23, 2026 |
| 1.6.5 | Apr 23, 2026 |
| 1.6.4 | Apr 23, 2026 |
| 1.6.3 | Apr 23, 2026 |
| 1.6.2 | Apr 23, 2026 |
| 1.6.1 | Apr 23, 2026 |
| 1.6.0 | Apr 22, 2026 |
| 1.5.8 | Apr 22, 2026 |
| 1.5.7 | Apr 22, 2026 |
| 1.5.6 | Apr 22, 2026 |
| 1.5.5 | Apr 22, 2026 |
| 1.5.4 | Apr 22, 2026 |
| 1.5.3 | Apr 22, 2026 |
| 1.5.2 | Apr 22, 2026 |
| 1.5.1 | Apr 22, 2026 |
Frequently asked questions
- Who maintains Obsidian Brain?
- Obsidian Brain is maintained by sweir1, which publishes 2 MCP servers (42 total versions) tracked on MCP Toplist.
- Is Obsidian Brain listed on the Official MCP Registry?
- Yes — Obsidian Brain is listed on the Official MCP Registry, alongside PulseMCP and Glama.
- How many versions does Obsidian Brain have?
- MCP Toplist tracks 42 versions of Obsidian Brain, most recently published on May 16, 2026.
- Where can I find the source code for Obsidian Brain?
- The source code for Obsidian Brain is hosted at github.com/sweir1/obsidian-brain.