Smart Connections
Let your coding agent semantically search your Obsidian vault via Smart Connections embeddings instead of guessing file paths.
Overview
io.github.gogogadgetbytes/smart-connections is a MCP server for the Build phase that exposes Obsidian Smart Connections semantic vault search to your AI assistant.
What is this MCP server?
- Stdio MCP server (@gogogadgetbytes/smart-connections-mcp) targeting Obsidian Smart Connections embeddings
- Semantic search across notes in a local vault—not keyword-only grep
- Requires VAULT_PATH env var (absolute path to your Obsidian vault)
- Version 0.2.0 npm package with GitHub source smart-connections-mcp
- Pairs with Claude Code, Cursor, and other MCP hosts for context from your second brain
- Package version 0.2.0 (@gogogadgetbytes/smart-connections-mcp)
- Single required env: VAULT_PATH
- Transport: stdio
Community signal: 2 GitHub stars.
What problem does it solve?
Your agent cannot see the ideas and specs locked in Obsidian unless you manually paste notes or remember exact filenames.
Who is it for?
Indie builders who live in Obsidian + Smart Connections and want Claude Code or Cursor to pull vault context on demand.
Skip if: Teams without Obsidian, vaults without Smart Connections embeddings, or builders who need hosted multi-user search outside a local machine.
What do I get? / Deliverables
After you set VAULT_PATH and register the server, the assistant can query your vault embeddings and surface the right notes while you build.
- Registered stdio MCP server the agent can call for vault semantic search
- Context snippets from relevant notes returned into the assistant session
- Repeatable local setup without shipping notes to a third-party search API
Recommended MCP Servers
Journey fit
Knowledge retrieval during implementation is a build-time agent workflow; the vault is living product and research docs the builder already maintains. Stdio MCP wiring is classic agent-tooling: expose local vault search as tools the assistant invokes while coding or planning in the repo.
How it compares
Local Obsidian embedding search via MCP—not a generic web scraper or a standalone RAG SaaS.
Common Questions / FAQ
Who is io.github.gogogadgetbytes/smart-connections for?
Solo builders and small teams who document in Obsidian with Smart Connections and want their coding agent to search that vault semantically.
When should I use io.github.gogogadgetbytes/smart-connections?
Use it during Build (and adjacent research) when you need the agent to find related notes, prior decisions, or specs without manual copy-paste.
How do I add io.github.gogogadgetbytes/smart-connections to my agent?
Install @gogogadgetbytes/smart-connections-mcp, set VAULT_PATH to your vault’s absolute path, and register the stdio server in Claude Code, Cursor, or your MCP host config.