# Nextcloud MCP Server

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, enabling auto…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add hithereiamaliff/mcp-nextcloud

# Browse available tools
npx -y @smithery/cli@latest tool list hithereiamaliff/mcp-nextcloud

# Get full schema for a tool
npx -y @smithery/cli@latest tool get hithereiamaliff/mcp-nextcloud nextcloud_calendar_create_event

# Call a tool
npx -y @smithery/cli@latest tool call hithereiamaliff/mcp-nextcloud nextcloud_calendar_create_event '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-nextcloud--hithereiamaliff.run.tools`

**Required config:**
- `nextcloudHost` (header) — Nextcloud server URL (for example https://cloud.example.com)
- `nextcloudUsername` (header) — Nextcloud username
- `nextcloudPassword` (header) — Nextcloud app password

## Tools (30)

- `nextcloud_calendar_create_event` — Create a new calendar event
- `nextcloud_calendar_delete_event` — Delete an event from calendar
- `nextcloud_calendar_get_event` — Get details of a specific event
- `nextcloud_calendar_list_calendars` — List all calendars in Nextcloud
- `nextcloud_calendar_list_events` — List events from a calendar
- `nextcloud_calendar_update_event` — Update an existing event
- `nextcloud_contacts_create_addressbook` — Create a new address book
- `nextcloud_contacts_create_contact` — Create a new contact
- `nextcloud_contacts_delete_addressbook` — Delete an address book
- `nextcloud_contacts_delete_contact` — Delete a contact
- `nextcloud_contacts_list_addressbooks` — List all address books
- `nextcloud_contacts_list_contacts` — List contacts from an address book
- `nextcloud_hello` — A simple test tool to verify that the MCP server is working correctly
- `nextcloud_notes_append_content` — Append content to an existing note
- `nextcloud_notes_create_note` — Create a new note in Nextcloud Notes
- `nextcloud_notes_delete_note` — Delete a note from Nextcloud Notes
- `nextcloud_notes_search_notes` — Search for notes in Nextcloud Notes
- `nextcloud_notes_update_note` — Update an existing note in Nextcloud Notes
- `nextcloud_tables_delete_row` — Delete a row from a table
- `nextcloud_tables_get_schema` — Get schema of a specific table
- `nextcloud_tables_insert_row` — Insert a new row into a table
- `nextcloud_tables_list_tables` — List all tables in Nextcloud Tables
- `nextcloud_tables_read_table` — Read data from a table
- `nextcloud_tables_update_row` — Update an existing row in a table
- `nextcloud_webdav_create_directory` — Create a new directory in Nextcloud
- `nextcloud_webdav_delete_resource` — Delete a file or directory from Nextcloud
- `nextcloud_webdav_list_directory` — List files and directories in Nextcloud
- `nextcloud_webdav_read_file` — Read content of a file from Nextcloud
- `nextcloud_webdav_search_files` — Search for files across Nextcloud using unified search - supports filename, content, and metadata search
- `nextcloud_webdav_write_file` — Write content to a file in Nextcloud

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get hithereiamaliff/mcp-nextcloud <tool-name>
```