Smart Connections
Bridges your Obsidian vault's Smart Connections embeddings to Claude through four read-only tools: search_by_text for freeform queries, search_similar for finding related notes, get_note for retrieving content, and list_indexed to see what's available. Uses Transformers.js locally to embed your text queries, then searches against the vector database Smart Connections already built. The security model is strict: all paths are validated against your vault root, symlinks are blocked, and there's zero write access. You need Smart Connections already installed and indexed in Obsidian. Useful when you want semantic search over your personal knowledge base without opening Obsidian or risking file system shenanigans.
- GitHub stars
- 2
- tools
- 6
- auth
- Required
- transport
- STDIO
- env var
- 1
- last updated
- Feb 3, 2026
Tools
6 toolsPublic tool metadata for what this MCP can expose to an agent.
search_by_textSearch using freeform text (computes embedding locally)
Search using freeform text (computes embedding locally)
No parameter schema in public metadata yet.
search_similarFind notes semantically similar to a given note
Find notes semantically similar to a given note
No parameter schema in public metadata yet.
search_by_embeddingSearch using a raw embedding vector
Search using a raw embedding vector
No parameter schema in public metadata yet.
get_noteGet content of a specific note (path validated)
Get content of a specific note (path validated)
No parameter schema in public metadata yet.
get_model_infoGet embedding model configuration
Get embedding model configuration
No parameter schema in public metadata yet.
list_indexedList all indexed notes
List all indexed notes
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
VAULT_PATH*Absolute path to your Obsidian vault (e.g., /Users/you/Documents/MyVault)
Readme
Smart Connections MCP Server
A security-first MCP server for Smart Connections. Read-only. Path-validated. Auditable.
Exposes Smart Connections embeddings to Claude Code and other MCP clients for semantic search of your Obsidian vault.
Why This Exists
We needed semantic search of our Obsidian vault from Claude Code. Existing options have problems:
- No path validation - User input passed directly to file operations
- Write access - Some expose mutation tools we don't need
- Heavy dependencies - PyTorch/transformers for what's essentially vector math
This implementation:
- Minimal dependencies - MCP SDK + Transformers.js (for text search)
- Fail-closed security - path validation with realpath, symlink detection
- Auditable - small TypeScript codebase you can actually read
Features
Details
- Repository
- github.com/gogogadgetbytes/smart-connections-mcp
- Categories
- Documents & Knowledge, Search & Web Crawling
- Package
@gogogadgetbytes/smart-connections-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
More from gogogadgetbytes
Related Documents & Knowledge MCP servers
View all
Parseflowlibres-coder/parseflowPDF parsing server with text extraction, metadata, search, images, and TOC via MCP2stars
Typebar (formerly SuperDocs)superdocsapp/superdocs-pluginAI document editing: edits the exact section, leaves the rest. 38 MCP tools; agent self-signup.0stars
Mcp Legal Doc Analyzerdbsectrainer/mcp-legal-doc-analyzerDomain-specific MCP tooling for legal document workflows1stars
Nebulamindduhokim/nebulamindAI astronomy wiki with open agent peer-review. Vote on evidence, propose edits, earn reputation.1stars
Tencent Lexiang MCP Servertencent-lexiang/lexiang-mcp-serverTencent Lexiang AI knowledge base MCP server for searching, managing entries, and editing docs.1stars
Provenote MCPxiaojiou176-open/provenoteFirst-party Provenote MCP server for drafts, research threads, auditable runs, and knowledge search.1stars