Welcome to Nextcloud MCP Server
Interactive user interface for semantic search and document retrieval. Test queries, visualize results, and explore your Nextcloud content using RAG workflows.
{{ auth_mode }}
About Semantic Search
This interface provides access to semantic search capabilities powered by vector embeddings. Unlike traditional keyword search, semantic search understands the meaning of your queries and finds conceptually similar content across your Nextcloud apps.
How it works:
- Documents from Notes, Calendar, Files, Contacts, and Deck are indexed into a vector database
- Each document chunk is converted to a 768-dimensional vector embedding that captures semantic meaning
- Queries are also converted to embeddings and matched against document vectors using similarity search
- Results can be retrieved using pure semantic search or hybrid BM25 search combining keywords and semantics
How Assistants Use This Data
An MCP client's LLM answers questions about your Nextcloud content by calling the
nc_semantic_search tool — a standard Retrieval-Augmented Generation (RAG)
flow driven entirely from the client side:
- Step 1: The assistant converts your question into a search query
- Step 2: The MCP server retrieves relevant document chunks using semantic search
- Step 3: Retrieved context is passed to the LLM to generate an informed answer
Key Point: This server retrieves context but never generates answers and holds no model credentials. Answer generation happens in the client, so you keep full control over which model is used.
Available Features
User Information
View your authentication details, session information, and IdP profile. Manage background access permissions.
Vector Sync Status
Monitor real-time indexing progress with metrics for indexed documents, pending queue, and synchronization status.
Vector Sync is Disabled
Semantic search and vector visualization features are currently disabled.
To enable these features, set VECTOR_SYNC_ENABLED=true in your environment configuration.
Learn more: Configuration Guide
Available Features
{% endif %}Documentation
For detailed information about configuration, authentication modes, and advanced features, please refer to the project documentation:
- Installation Guide
- Configuration Options
- Authentication Modes {% if vector_sync_enabled %}
- Vector Sync UI Guide {% endif %}