ai.smithery/hithereiamaliff-mcp-nextcloud

Install

Config snippet generator goes here (5 client tabs)

README

# Nextcloud MCP Server

**MCP Endpoint:** `https://mcp.techmavie.digital/nextcloud/mcp`

> **Note:** This project is a complete rewrite in TypeScript of the original Python-based [cbcoutinho/nextcloud-mcp-server](https://github.com/cbcoutinho/nextcloud-mcp-server), now with **self-hosted VPS deployment** and **Smithery deployment support**.
>
> ### Key Differences from the Original Repository:
> *   **Language:** This project is written in TypeScript, while the original is in Python.
> *   **Smithery Support:** Added full support for Smithery deployment and local testing via Smithery playground.
> *   **Project Structure:** The project structure has been adapted for a Node.js/TypeScript environment with MCP SDK integration.
> *   **Dependencies:** This project uses npm for package management, whereas the original uses Python's dependency management tools.
> *   **Deployment:** Now supports both local development and cloud deployment via Smithery.

The Nextcloud MCP (Model Context Protocol) server allows Large Language Models (LLMs) like OpenAI's GPT, Google's Gemini, or Anthropic's Claude to interact with your Nextcloud instance. This enables automation of various Nextcloud actions across Notes, Calendar, Contacts, Tables, and WebDAV file operations.

The hosted HTTP integration now supports a safer multi-user flow through the MCP Key Service. Instead of embedding raw Nextcloud credentials in the connector URL, hosted clients can use a user-scoped `usr_...` key and let the server resolve credentials server-side.

## Features

The server provides integration with multiple Nextcloud apps, enabling LLMs to interact with your Nextcloud data through a comprehensive set of **30 tools** across 5 main categories.

## Supported Nextcloud Apps

| App | Support Status | Description |
|-----|----------------|-------------|
| **Notes** | ✅ Full Support | Create, read, update, delete, search, and append to notes. |
| **Calendar** | ✅ Full Support | Complete calendar integration - manage calendars and events via CalDAV. |
| **Tables** | ✅ Full Support | Complete table operations - list tables, get schemas, and perform CRUD operations on rows. |
| **Files (WebDAV)** | ✅ Full Support | Complete file system access - browse directories, read/write files, create/delete resources. |
| **Contacts** | ✅ Full Support | Create, read, update, and delete contacts and address books via CardDAV. |

## Available Tools (30 Total)

### 📝 Notes Tools (5 tools)

| Tool | Description |
|------|-------------|
| `nextcloud_notes_create_note` | Create a new note with title, content, and category |
| `nextcloud_notes_update_note` | Update an existing note by ID with optional title, content, or category |
| `nextcloud_notes_append_content` | Append content to an existing note with a clear separator |
| `nextcloud_notes_search_notes` | Search notes by title or content with result filtering |
| `nextcloud_notes_delete_note` | Delete a note by ID |

### 📅 Calendar Tools (6 tools)

| Tool | Description |
|------|-------------|
| `nextcloud_calendar_list_calendars` | List all available calendars for the user |
| `nextcloud_calendar_create_event` | Create a calendar event with summary, description, dates, and location |
| `nextcloud_calendar_list_events` | List events from a calendar with optional date filtering |
| `nextcloud_calendar_get_event` | Get detailed information about a specific event |
| `nextcloud_calendar_update_event` | Update any aspect of an existing event |
| `nextcloud_calendar_delete_event` | Delete a calendar event |

### 👥 Contacts Tools (6 tools)

| Tool | Description |
|------|-------------|
| `nextcloud_contacts_list_addressbooks` | List all available addressbooks for the user |
| `nextcloud_contacts_create_addressbook` | Create a new addressbook with display name and description |
| `nextcloud_contacts_delete_addressbook` | Delete an addressbook by ID |
| `nextcloud_contacts_list_contacts` | List all contacts in a specific addressbook |
| `nextcloud_contacts_create_contact` | Create a new contact with full name, emails, phones, addresses, and organizations |
| `nextcloud_contacts_delete_contact` | Delete a contact from an addressbook |

### 📊 Tables Tools (6 tools)

| Tool | Description |
|------|-------------|
| `nextcloud_tables_list_tables` | List all tables available to the user |
| `nextcloud_tables_get_schema` | Get the schema/structure of a specific table including columns |
| `nextcloud_tables_read_table` | Read all rows from a table |
| `nextcloud_tables_insert_row` | Insert a new row into a table with key-value data |
| `nextcloud_tables_update_row` | Update an existing row in a table |
| `nextcloud_tables_delete_row` | Delete a row from a table |

### 📁 WebDAV File System Tools (6 tools)

| Tool | Description |
|------|-------------|
| `nextcloud_webdav_search_files` | **🔍 NEW!** Unified search across filenames, content, and metadata - no need to specify exact paths |
| `nextcloud_webdav_list_directory` | List