Smart Connections MCP Server
A security-first MCP server for Smart Connections. Read-only. Path-validated. Auditable. Its README documents 6 tools, including search_by_text, search_similar, search_by_embedding. It runs locally over stdio via the published package.
People who work with Vault and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.
VERIFIED ACTIVE
LAST COMMIT 2026-02-03 · ★ 3 · VERIFIED 2026-09-30
MIT · TypeScript servers · how we verify → /methodology
01 · Install Smart Connections
before you install - you'll need
VAULT_PATH
Environment variables documented in the project's README - it lists which are required and which have defaults.
Claude Code
claude mcp add gogogadgetbytes-smart-connections-mcp -- npx -y @gogogadgetbytes/smart-connections-mcpClaude Desktop / Cursor / VS Code - add to config
{
"mcpServers": {
"gogogadgetbytes-smart-connections-mcp": {
"command": "npx",
"args": [
"-y",
"@gogogadgetbytes/smart-connections-mcp"
]
}
}
}Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.
Using another client? Same JSON, different key
Claude Desktop · mcpServers
Cursor · mcpServers
VS Code · servers
Windsurf · mcpServers
Zed · context_servers
Cline · mcpServers
Roo Code · mcpServers
Continue · mcpServers
LibreChat · mcpServers
Gemini CLI · mcpServers
Codex CLI · mcp_servers
Full setup guides: every client.
02 · Evidence
Security posture
What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.
runs as local process (stdio) - runs on your machine with your user's permissions
license MIT - declared in the repository
npm package @gogogadgetbytes/smart-connections-mcp - published under the repo owner's npm scope (@gogogadgetbytes)
registry namespace io.github.gogogadgetbytes is GitHub-verified and matches the repo owner
03 · What Smart Connections can do
Prose above is summarized from the project's README and registry record - no invented capabilities.
What you can build
With this server connected, an agent can search using freeform text (computes embedding locally), find notes semantically similar to a given note, search using a raw embedding vector, and get content of a specific note (path validated).
The 6 tools it gives your agent
Extracted from the project's README - what smart-connections lets an agent do.
- 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
Limitations (from the README)
- Single vault - Configure one vault per MCP server instance - Index from Smart Connections - Note embeddings come from the plugin; text queries are embedded locally - No write access - By design; use Obsidian for edits - First run downloads model - ~50MB model cached in ~/.cache/huggingface/
04 · Who maintains Smart Connections
smart-connections is maintained by gogogadgetbytes. We track 2 MCP servers from gogogadgetbytes - 2 actively maintained, 13 combined GitHub stars, oldest repo from Jan 2026. Full record: all servers from gogogadgetbytes.
05 · Facts
- category
- productivity - actively maintained as of 2026-09-30.
- registry
- io.github.gogogadgetbytes/smart-connections (active, first published 2026-02-03)
- packages
- npm:@gogogadgetbytes/smart-connections-mcp
06 · Smart Connections FAQ
Is Smart Connections still maintained?
Yes - as of 2026-09-30, its last commit was 2026-02-03. We re-verify nightly.
What can Smart Connections do?
With this server connected, an agent can search using freeform text (computes embedding locally), find notes semantically similar to a given note, search using a raw embedding vector, and get content of a specific note (path validated).
How do I install Smart Connections?
Run `npx -y @gogogadgetbytes/smart-connections-mcp`. The README documents one environment variable (VAULT_PATH) to set first. You can also paste the ready-made client config above.
Does Smart Connections run locally?
Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.
07 · Alternatives to Smart Connections
Alternatives to Smart Connections
Maintained productivity servers if Smart Connections isn't the fit.
- Kaneo Official MCP server for Kaneo: manage tasks, projects, and labels from Claude and other MCP clients ★ 9,290 · 2026-09-30
- Praison AI AI Agents Framework with Self Reflection and MCP support ★ 9,111 · 2026-09-30
- Basic Memory Local-first knowledge management with bi-directional LLM sync via Markdown files. ★ 4,068 · 2026-09-30
- Mindwtr Task and project automation for local and self-hosted Mindwtr Cloud data; read-only by default. ★ 2,162 · 2026-09-30
- Pm Claude Skills 1176 professional Agent Skills + workflow recipes - searchable & fetchable over MCP. ★ 1,415 · 2026-09-30
- Atlassian Rovo MCP Server Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work. ★ 1,072 · 2026-09-15
Pairs well with
Servers that cover what Smart Connections doesn't - only shown when the pairing reason fits the companion.
More productivity MCP servers · Easy Notion · Kanera · Airmcp · Intervals Icu MCP · Hint Services Obsidian GitHub MCP
More TypeScript MCP servers · Deckaura Tarot · Guardvibe · Test Coverage MCP · Golf Intelligence, by Stracka · Suunto MCP · see all