Hithereiamaliff MCP Nextcloud

What hithereiamaliff-mcp-nextcloud MCP server does

The hithereiamaliff-mcp-nextcloud MCP server gives an MCP-compatible assistant access to five areas of a Nextcloud instance: Notes, Calendar, Contacts, Tables, and files exposed through WebDAV. Its tools cover common read and write operations, so an agent can maintain notes, manage events, inspect address books, edit table rows, and work with files and directories.

The Notes tools support creating, editing, appending to, searching, and deleting notes. Calendar tools list calendars and events, retrieve event details, and create, modify, or remove events. Contacts tools manage address books and contacts, including contact fields such as names, email addresses, phone numbers, addresses, and organizations. Tables tools expose table listings, schemas, row reads, inserts, updates, and deletes.

How it works

The server presents these Nextcloud operations through the Model Context Protocol. Calendar access uses CalDAV, contacts use CardDAV, and file operations use WebDAV, according to the project documentation. The WebDAV search tool can search filenames, file content, or metadata without requiring an exact path. Searches can also use file-type, directory, size, date, result-count, case-sensitivity, and directory-depth filters. Optional previews can be returned for matching text files.

File search supports an optimized mode for broad or root-directory searches, while narrower base paths and depth limits can reduce the search area. The project also describes caching, timeout protection, parallel processing, and fallback behavior for this search workflow.

Setup and configuration

The hithereiamaliff-mcp-nextcloud MCP server is available through the hosted MCP endpoint https://mcp.techmavie.digital/nextcloud/mcp. The hosted integration supports a user-scoped usr_... MCP key; the server resolves the associated Nextcloud credentials instead of placing raw credentials in the connector URL.

The repository is a TypeScript and Node.js implementation using the MCP SDK and npm-based project management. It supports local development and cloud deployment through Smithery, including local testing with the Smithery playground. The supplied material does not specify local environment variable names or a complete local installation command, so those details should be taken from the repository’s current deployment instructions.

Tools and capabilities

The available tools are grouped by service:

• Notes: create, update, append, search, and delete notes.
• Calendar: list calendars; create, list, inspect, update, and delete events.
• Contacts: list, create, and delete address books; list, create, and delete contacts.
• Tables: list tables, inspect schemas, and perform row-level read, insert, update, and delete operations.
• WebDAV: search files, list directories, read and write files, create directories, and delete resources.

The WebDAV search interface accepts a required query and can search filename, content, and metadata scopes. It can return a bounded result set, include content previews, restrict file extensions, and apply date or byte-size ranges.

Limitations and notes

Write operations can change or delete Nextcloud data, including notes, events, contacts, table rows, files, and directories, so agents should use them with appropriate confirmation policies. The available material does not document Nextcloud version requirements, permission requirements, local configuration variables, or the exact behavior of every underlying app when permissions are restricted. The listed contact tools do not include a separate contact-update operation, although address books and contacts can be listed, created, and deleted.