Claude MarketplacesSubmit
hithereiamaliff avatar

Hithereiamaliff Mcp Nextcloud

hithereiamaliff/mcp-nextcloud

A TypeScript rewrite of the original Python Nextcloud MCP that exposes 30 tools across Notes, Calendar, Contacts, Tables, and WebDAV file operations. The standout feature is the unified WebDAV search that lets you query filenames, content, and metadata without knowing exact paths, with intelligent ranking and filtering by file type, size, and date range. Beyond search, you get full CRUD on notes, calendar events via CalDAV, contacts via CardDAV, table rows, and filesystem operations like directory browsing and file read/write. Deployed as a remote HTTP service through Smithery with multi-user support via scoped keys. Reach for this when you need an LLM to read meeting notes, create calendar events, search documents, or manage contacts across your self-hosted Nextcloud instance.

GitHub stars
36
tools
30
auth
Secret needed
transport
HTTP
last updated
Sep 11, 2025
View on GitHub

Tools

30 tools

Public tool metadata for what this MCP can expose to an agent.

nextcloud_calendar_create_eventCreate a new calendar event2 params

Create a new calendar event

Parameters* required
calendarIdstring
The ID of the calendar
eventobject
Event data
nextcloud_calendar_delete_eventDelete an event from calendar2 params

Delete an event from calendar

Parameters* required
calendarIdstring
The ID of the calendar
eventIdstring
The ID of the event
nextcloud_calendar_get_eventGet details of a specific event2 params

Get details of a specific event

Parameters* required
calendarIdstring
The ID of the calendar
eventIdstring
The ID of the event
nextcloud_calendar_list_calendarsList all calendars in Nextcloud

List all calendars in Nextcloud

No parameter schema in public metadata yet.

nextcloud_calendar_list_eventsList events from a calendar3 params

List events from a calendar

Parameters* required
calendarIdstring
The ID of the calendar
endstring
End date filter (ISO format)
startstring
Start date filter (ISO format)
nextcloud_calendar_update_eventUpdate an existing event3 params

Update an existing event

Parameters* required
calendarIdstring
The ID of the calendar
eventobject
Updated event data
eventIdstring
The ID of the event
nextcloud_contacts_create_addressbookCreate a new address book2 params

Create a new address book

Parameters* required
descriptionstring
Description of the address book
displayNamestring
Display name for the address book
nextcloud_contacts_create_contactCreate a new contact2 params

Create a new contact

Parameters* required
addressBookIdstring
The ID of the address book
contactobject
Contact information
nextcloud_contacts_delete_addressbookDelete an address book1 params

Delete an address book

Parameters* required
addressBookIdstring
The ID of the address book to delete
nextcloud_contacts_delete_contactDelete a contact2 params

Delete a contact

Parameters* required
addressBookIdstring
The ID of the address book
contactIdstring
The ID of the contact to delete
nextcloud_contacts_list_addressbooksList all address books

List all address books

No parameter schema in public metadata yet.

nextcloud_contacts_list_contactsList contacts from an address book1 params

List contacts from an address book

Parameters* required
addressBookIdstring
The ID of the address book
nextcloud_helloA simple test tool to verify that the MCP server is working correctly

A simple test tool to verify that the MCP server is working correctly

No parameter schema in public metadata yet.

nextcloud_notes_append_contentAppend content to an existing note2 params

Append content to an existing note

Parameters* required
contentstring
The content to append
note_idnumber
The ID of the note to append to
nextcloud_notes_create_noteCreate a new note in Nextcloud Notes3 params

Create a new note in Nextcloud Notes

Parameters* required
categorystring
The category of the note
contentstring
The content of the note
titlestring
The title of the note
nextcloud_notes_delete_noteDelete a note from Nextcloud Notes1 params

Delete a note from Nextcloud Notes

Parameters* required
note_idnumber
The ID of the note to delete
nextcloud_notes_search_notesSearch for notes in Nextcloud Notes1 params

Search for notes in Nextcloud Notes

Parameters* required
querystring
The search query
nextcloud_notes_update_noteUpdate an existing note in Nextcloud Notes5 params

Update an existing note in Nextcloud Notes

Parameters* required
categorystring
The new category of the note
contentstring
The new content of the note
etagstring
The etag of the note for concurrency control
note_idnumber
The ID of the note to update
titlestring
The new title of the note
nextcloud_tables_delete_rowDelete a row from a table2 params

Delete a row from a table

Parameters* required
rowIdstring
The ID of the row to delete
tableIdstring
The ID of the table
nextcloud_tables_get_schemaGet schema of a specific table1 params

Get schema of a specific table

Parameters* required
tableIdstring
The ID of the table
nextcloud_tables_insert_rowInsert a new row into a table2 params

Insert a new row into a table

Parameters* required
rowstring
Row data as key-value pairs
tableIdstring
The ID of the table
nextcloud_tables_list_tablesList all tables in Nextcloud Tables

List all tables in Nextcloud Tables

No parameter schema in public metadata yet.

nextcloud_tables_read_tableRead data from a table1 params

Read data from a table

Parameters* required
tableIdstring
The ID of the table
nextcloud_tables_update_rowUpdate an existing row in a table3 params

Update an existing row in a table

Parameters* required
rowstring
Updated row data as key-value pairs
rowIdstring
The ID of the row
tableIdstring
The ID of the table
nextcloud_webdav_create_directoryCreate a new directory in Nextcloud1 params

Create a new directory in Nextcloud

Parameters* required
pathstring
The path of the directory to create
nextcloud_webdav_delete_resourceDelete a file or directory from Nextcloud1 params

Delete a file or directory from Nextcloud

Parameters* required
pathstring
The path to the file or directory to delete
nextcloud_webdav_list_directoryList files and directories in Nextcloud1 params

List files and directories in Nextcloud

Parameters* required
pathstring
The path to list (e.g., "/" for root)
nextcloud_webdav_read_fileRead content of a file from Nextcloud1 params

Read content of a file from Nextcloud

Parameters* required
pathstring
The path to the file to read
nextcloud_webdav_search_filesSearch for files across Nextcloud using unified search - supports filename, content, and metadata search11 params

Search for files across Nextcloud using unified search - supports filename, content, and metadata search

Parameters* required
basePathstring
Limit search to specific directory (e.g., "/Documents", "/Projects")default: /
caseSensitiveboolean
Whether search should be case sensitivedefault: false
dateRangeobject
Filter by last modified date range
fileTypesarray
Filter by file extensions (e.g., ["pdf", "txt", "md", "js"])
includeContentboolean
Include content preview in results (for text files)default: false
limitnumber
Maximum number of results to returndefault: 50
maxDepthnumber
Maximum directory depth to search (1-10, default: 3)default: 3
querystring
Search terms (supports multiple words, e.g., "budget report 2024")
quickSearchboolean
Use quick search mode (faster, limited depth) for root directory searchesdefault: true
searchInarray
What to search in: filename, content, and/or metadata
sizeRangeobject
Filter by file size range
nextcloud_webdav_write_fileWrite content to a file in Nextcloud2 params

Write content to a file in Nextcloud

Parameters* required
contentstring
The content to write to the file
pathstring
The path to the file to write

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

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, 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.

View the full README on GitHub

Details

Repository
github.com/hithereiamaliff/mcp-nextcloud
Transport
HTTP
Auth
Required
Registry
MCP registry, active

More from hithereiamaliff