MCP server for Obsidian Smart Connections. Semantic search using your vault's embeddings.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"smart-connections": {
"env": {
"VAULT_PATH": "/path/to/your/obsidian/vault"
},
"args": [
"/path/to/smart-connections-mcp/dist/index.js"
],
"command": "node"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
A security-first MCP server for Smart Connections. Read-only. Path-validated. Auditable.
No automated test available for this server. Check the GitHub README for setup instructions.
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
No package registry to scan.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in search / productivity
Persistent memory using a knowledge graph
Dynamic problem-solving through sequential thought chains
Web and local search using Brave Search API
Production ready MCP server with real-time search, extract, map & crawl.
MCP Security Weekly
Get CVE alerts and security updates for Smart Connections MCP Server and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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.
We needed semantic search of our Obsidian vault from Claude Code. Existing options have problems:
This implementation:
| Property | Guarantee |
|---|---|
| Path confinement | All file access validated against vault root |
| No traversal | ../ and symlink attacks blocked |
| Read-only | No write operations exposed |
| Bounded responses | Capped results (50), content length (10KB) |
| Fail closed | Errors deny access, never bypass |
| Audit logging | Security events logged with context |
git clone https://github.com/gogogadgetbytes/smart-connections-mcp
cd smart-connections-mcp
npm install
npm run build
Add to your Claude Code config:
claude mcp add smart-connections \
-e VAULT_PATH="/path/to/your/obsidian/vault" \
-- node /path/to/smart-connections-mcp/dist/index.js
Or manually add to ~/.claude.json:
{
"mcpServers": {
"smart-connections": {
"command": "node",
"args": ["/path/to/smart-connections-mcp/dist/index.js"],
"env": {
"VAULT_PATH": "/path/to/your/obsidian/vault"
}
}
}
}
Restart Claude Code to load the server.
Once configured, Claude Code can use these tools:
"Search my vault for notes about backup strategies"
→ Uses search_by_text tool
"Find notes similar to Topics/Claude_Code.md"
→ Uses search_similar tool
"Show me the content of Topics/Obsidian.md"
→ Uses get_note tool
"What notes are indexed in my vault?"
→ Uses list_indexed tool
| Tool | Description |
|---|---|
search_by_text | Search using freeform text (computes embedding locally) |
search_similar | Find notes semantically similar to a given note |
search_by_embedding | Search using a raw embedding vector |
get_note | Get content of a specific note (path validated) |
get_model_info | Get embedding model configuration |
list_indexed | List all indexed notes |
| Variable | Required | Description |
|---|---|---|
VAULT_PATH | Yes | Absolute path to Obsidian vault |