constella-desktop
Index all your local files + cloud apps privately, on-device with VectorDB & KnowledgeGraph in one
Constella Desktop is an MCP server that indexes local files and folders into a private, on-device vector database and knowledge graph. It syncs chosen directories—Obsidian vaults, Documents, Downloads, or custom folders—extracts text from PDF, DOCX, Markdown, and images, then embeds content using a local offline model (EmbeddingGemma) into LanceDB and SQLite. The server runs scheduled analysis passes to cluster related material into concept pages and themes, then exposes semantic search, source listing, and note retrieval as MCP tools for Claude Code and compatible clients.
Key Features
Use Cases
- 01Give Claude Code semantic search across your Obsidian vaults, project notes, and documents
- 02Build a private JARVIS-style assistant that indexes and retrieves personal knowledge on-device
- 03Automate workflows that need to search, read, or write to a local knowledge base without cloud syncing
- 04Connect scattered notes, research, and agent workspaces into a unified concept graph
- 05Run local-first personal AI tooling with full control over data privacy and storage
- 06Replace or augment cloud note apps with an offline, agent-accessible knowledge substrate
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
constella-desktop — FAQ
What is the Constella Desktop MCP server?+
It is a local-first desktop application that indexes your chosen folders into a private vector database and knowledge graph, then exposes semantic search and note management as MCP tools for Claude Code and other MCP clients. All data stays on your machine.
How do I install and connect Constella Desktop to Claude Code?+
Clone the repository, run npm install, configure a Firebase project in .env.local, then start the app with npm start. Add the MCP server to your Claude Code config JSON with command node and args pointing to dist/main/main.js --mcp-only.
Which AI clients work with Constella Desktop?+
Any MCP-compatible client can use it, including Claude Code and Claude Desktop. The README specifically documents Claude Code integration.
Do I need API keys or a cloud account to use Constella?+
You need a free Firebase Spark project for authentication (Email/Password and Google sign-in enabled). The embedding model runs fully offline. Optional cloud LLM providers can be configured for graph synthesis but are not required.
Is Constella Desktop free to use?+
The code is open source under CC BY-NC 4.0, which permits non-commercial use only. Commercial use requires separate permission from the author.
What files and formats does Constella index?+
It extracts and indexes text from PDF, DOCX, Markdown, images, and plain text files in any local folder you choose. The indexer chunks content and embeds it using a local 512-dimensional EmbeddingGemma model.
How do I install constella-desktop?+
Open the source repository on GitHub and follow its README. constella-desktop is a mcp server — MCP Agents Market links you directly to the official repo.
Is constella-desktop free?+
constella-desktop is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.