hithereiamaliff-mcp-nextcloud

{
  "name": "mcp-nextcloud",
  "tags": [
    "mcp",
    "model-context-protocol",
    "nextcloud",
    "ai",
    "llm",
    "automation",
    "file-management"
  ],
  "tools": [
    {
      "name": "nc_notes_create_note",
      "description": "Create a new note in Nextcloud Notes",
      "input_schema": {
        "type": "object",
        "required": [
          "title",
          "content",
          "category"
        ],
        "properties": {
          "title": {
            "type": "string",
            "description": "The title of the note"
          },
          "content": {
            "type": "string",
            "description": "The content of the note"
          },
          "category": {
            "type": "string",
            "description": "The category of the note"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "etag": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "category": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "nc_notes_update_note",
      "description": "Update an existing note in Nextcloud Notes",
      "input_schema": {
        "type": "object",
        "required": [
          "note_id",
          "etag"
        ],
        "properties": {
          "etag": {
            "type": "string",
            "description": "The etag of the note for concurrency control"
          },
          "title": {
            "type": "string",
            "description": "The new title of the note"
          },
          "content": {
            "type": "string",
            "description": "The new content of the note"
          },
          "note_id": {
            "type": "number",
            "description": "The ID of the note to update"
          },
          "category": {
            "type": "string",
            "description": "The new category of the note"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "etag": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "success": {
            "type": "boolean"
          },
          "category": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "nc_notes_append_content",
      "description": "Append content to an existing note",
      "input_schema": {
        "type": "object",
        "required": [
          "note_id",
          "content"
        ],
        "properties": {
          "content": {
            "type": "string",
            "description": "The content to append"
          },
          "note_id": {
            "type": "number",
            "description": "The ID of the note to append to"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "etag": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "appended_content": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "nc_notes_delete_note",
      "description": "Delete a note from Nextcloud Notes",
      "input_schema": {
        "type": "object",
        "required": [
          "note_id"
        ],
        "properties": {
          "note_id": {
            "type": "number",
            "description": "The ID of the note to delete"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          },
          "deleted_id": {
            "type": "number"
          },
          "status_code": {
            "type": "number"
          }
        }
      }
    },
    {
      "name": "nc_notes_search_notes",
      "description": "Search for notes in Nextcloud Notes",
      "input_schema": {
        "type": "object",
        "required": [
          "query"
        ],
        "properties": {
          "query": {
            "type": "string",
            "description": "The search query"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "category": {
                  "type": "string"
                }
              }
            }
          },
          "total_found": {
            "type": "number"
          }
        }
      }
    },
    {
      "name": "nc_calendar_list_calendars",
      "description": "List all calendars in Nextcloud",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "displayName": {
              "type": "string"
            }
          }
        }
      }
    },
    {
      "name": "nc_calendar_create_event",
      "description": "Create a new calendar event",
      "input_schema": {
        "type": "object",
        "required": [
          "calendarId",
          "event"
        ],
        "properties": {
          "event": {
            "type": "object",
            "properties": {
              "dtend": {
                "type": "string"
              },
              "dtstart": {
                "type": "string"
              },
              "summary": {
                "type": "string"
              },
              "location": {
                "type": "string"
              },
              "description": {
                "type": "string"
              }
            }
          },
          "calendarId": {
            "type": "string",
            "description": "The ID of the calendar"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "dtend": {
            "type": "string"
          },
          "dtstart": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "location": {
            "type": "string"
          },
          "description": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "nc_calendar_list_events",
      "description": "List events from a calendar",
      "input_schema": {
        "type": "object",
        "required": [
          "calendarId"
        ],
        "properties": {
          "end": {
            "type": "string"
          },
          "start": {
            "type": "string"
          },
          "calendarId": {
            "type": "string",
            "description": "The ID of the calendar"
          }
        }
      },
      "output_schema": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "dtend": {
              "type": "string"
            },
            "dtstart": {
              "type": "string"
            },
            "summary": {
              "type": "string"
            },
            "location": {
              "type": "string"
            },
            "description": {
              "type": "string"
            }
          }
        }
      }
    },
    {
      "name": "nc_calendar_get_event",
      "description": "Get details of a specific event",
      "input_schema": {
        "type": "object",
        "required": [
          "calendarId",
          "eventId"
        ],
        "properties": {
          "eventId": {
            "type": "string",
            "description": "The ID of the event"
          },
          "calendarId": {
            "type": "string",
            "description": "The ID of the calendar"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "dtend": {
            "type": "string"
          },
          "dtstart": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "location": {
            "type": "string"
          },
          "description": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "nc_calendar_update_event",
      "description": "Update an existing event",
      "input_schema": {
        "type": "object",
        "required": [
          "calendarId",
          "eventId",
          "event"
        ],
        "properties": {
          "event": {
            "type": "object",
            "properties": {
              "dtend": {
                "type": "string"
              },
              "dtstart": {
                "type": "string"
              },
              "summary": {
                "type": "string"
              },
              "location": {
                "type": "string"
              },
              "description": {
                "type": "string"
              }
            }
          },
          "eventId": {
            "type": "string",
            "description": "The ID of the event"
          },
          "calendarId": {
            "type": "string",
            "description": "The ID of the calendar"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "dtend": {
            "type": "string"
          },
          "dtstart": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "location": {
            "type": "string"
          },
          "description": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "nc_calendar_delete_event",
      "description": "Delete an event from calendar",
      "input_schema": {
        "type": "object",
        "required": [
          "calendarId",
          "eventId"
        ],
        "properties": {
          "eventId": {
            "type": "string",
            "description": "The ID of the event"
          },
          "calendarId": {
            "type": "string",
            "description": "The ID of the calendar"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          },
          "status_code": {
            "type": "number"
          }
        }
      }
    },
    {
      "name": "nc_contacts_list_addressbooks",
      "description": "List all address books",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "displayName": {
              "type": "string"
            }
          }
        }
      }
    },
    {
      "name": "nc_contacts_create_addressbook",
      "description": "Create a new address book",
      "input_schema": {
        "type": "object",
        "required": [
          "displayName",
          "description"
        ],
        "properties": {
          "description": {
            "type": "string",
            "description": "Description of the address book"
          },
          "displayName": {
            "type": "string",
            "description": "Display name for the address book"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "displayName": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "nc_contacts_delete_addressbook",
      "description": "Delete an address book",
      "input_schema": {
        "type": "object",
        "required": [
          "addressBookId"
        ],
        "properties": {
          "addressBookId": {
            "type": "string",
            "description": "The ID of the address book to delete"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          },
          "status_code": {
            "type": "number"
          }
        }
      }
    },
    {
      "name": "nc_contacts_list_contacts",
      "description": "List contacts from an address book",
      "input_schema": {
        "type": "object",
        "required": [
          "addressBookId"
        ],
        "properties": {
          "addressBookId": {
            "type": "string",
            "description": "The ID of the address book"
          }
        }
      },
      "output_schema": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "fn": {
              "type": "string"
            },
            "id": {
              "type": "string"
            },
            "adr": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "org": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "tel": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "note": {
              "type": "string"
            },
            "email": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    {
      "name": "nc_contacts_create_contact",
      "description": "Create a new contact",
      "input_schema": {
        "type": "object",
        "required": [
          "addressBookId",
          "contact"
        ],
        "properties": {
          "contact": {
            "type": "object",
            "properties": {
              "fn": {
                "type": "string"
              },
              "adr": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "org": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "tel": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "note": {
                "type": "string"
              },
              "email": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "addressBookId": {
            "type": "string",
            "description": "The ID of the address book"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "fn": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "adr": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "org": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "tel": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "note": {
            "type": "string"
          },
          "email": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    },
    {
      "name": "nc_contacts_delete_contact",
      "description": "Delete a contact",
      "input_schema": {
        "type": "object",
        "required": [
          "addressBookId",
          "contactId"
        ],
        "properties": {
          "contactId": {
            "type": "string",
            "description": "The ID of the contact to delete"
          },
          "addressBookId": {
            "type": "string",
            "description": "The ID of the address book"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          },
          "status_code": {
            "type": "number"
          }
        }
      }
    },
    {
      "name": "nc_tables_list_tables",
      "description": "List all tables in Nextcloud Tables",
      "input_schema": {
        "type": "object",
        "required": [],
        "properties": {}
      },
      "output_schema": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": "string"
            }
          }
        }
      }
    },
    {
      "name": "nc_tables_get_schema",
      "description": "Get schema of a specific table",
      "input_schema": {
        "type": "object",
        "required": [
          "tableId"
        ],
        "properties": {
          "tableId": {
            "type": "string",
            "description": "The ID of the table"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "schema": {
            "type": "object"
          }
        }
      }
    },
    {
      "name": "nc_tables_read_table",
      "description": "Read data from a table",
      "input_schema": {
        "type": "object",
        "required": [
          "tableId"
        ],
        "properties": {
          "tableId": {
            "type": "string",
            "description": "The ID of the table"
          }
        }
      },
      "output_schema": {
        "type": "array",
        "items": {
          "type": "object"
        }
      }
    },
    {
      "name": "nc_tables_insert_row",
      "description": "Insert a new row into a table",
      "input_schema": {
        "type": "object",
        "required": [
          "tableId",
          "row"
        ],
        "properties": {
          "row": {
            "type": "object",
            "description": "Row data as key-value pairs"
          },
          "tableId": {
            "type": "string",
            "description": "The ID of the table"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "row": {
            "type": "object"
          }
        }
      }
    },
    {
      "name": "nc_tables_update_row",
      "description": "Update an existing row in a table",
      "input_schema": {
        "type": "object",
        "required": [
          "tableId",
          "rowId",
          "row"
        ],
        "properties": {
          "row": {
            "type": "object",
            "description": "Updated row data as key-value pairs"
          },
          "rowId": {
            "type": "string",
            "description": "The ID of the row"
          },
          "tableId": {
            "type": "string",
            "description": "The ID of the table"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "row": {
            "type": "object"
          }
        }
      }
    },
    {
      "name": "nc_tables_delete_row",
      "description": "Delete a row from a table",
      "input_schema": {
        "type": "object",
        "required": [
          "tableId",
          "rowId"
        ],
        "properties": {
          "rowId": {
            "type": "string",
            "description": "The ID of the row to delete"
          },
          "tableId": {
            "type": "string",
            "description": "The ID of the table"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          },
          "status_code": {
            "type": "number"
          }
        }
      }
    },
    {
      "name": "nc_webdav_list_directory",
      "description": "List files and directories in Nextcloud",
      "input_schema": {
        "type": "object",
        "required": [
          "path"
        ],
        "properties": {
          "path": {
            "type": "string",
            "description": "The path to list (e.g., '/' for root)"
          }
        }
      },
      "output_schema": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            },
            "isDirectory": {
              "type": "boolean"
            }
          }
        }
      }
    },
    {
      "name": "nc_webdav_read_file",
      "description": "Read content of a file from Nextcloud",
      "input_schema": {
        "type": "object",
        "required": [
          "path"
        ],
        "properties": {
          "path": {
            "type": "string",
            "description": "The path to the file to read"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string"
          }
        }
      }
    },
    {
      "name": "nc_webdav_write_file",
      "description": "Write content to a file in Nextcloud",
      "input_schema": {
        "type": "object",
        "required": [
          "path",
          "content"
        ],
        "properties": {
          "path": {
            "type": "string",
            "description": "The path to the file to write"
          },
          "content": {
            "type": "string",
            "description": "The content to write to the file"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          },
          "status_code": {
            "type": "number"
          }
        }
      }
    },
    {
      "name": "nc_webdav_create_directory",
      "description": "Create a new directory in Nextcloud",
      "input_schema": {
        "type": "object",
        "required": [
          "path"
        ],
        "properties": {
          "path": {
            "type": "string",
            "description": "The path of the directory to create"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          },
          "status_code": {
            "type": "number"
          }
        }
      }
    },
    {
      "name": "nc_webdav_delete_resource",
      "description": "Delete a file or directory from Nextcloud",
      "input_schema": {
        "type": "object",
        "required": [
          "path"
        ],
        "properties": {
          "path": {
            "type": "string",
            "description": "The path to the file or directory to delete"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          },
          "status_code": {
            "type": "number"
          }
        }
      }
    },
    {
      "name": "nc_webdav_search_files",
      "description": "Search for files across Nextcloud using unified search - supports filename, content, and metadata search",
      "input_schema": {
        "type": "object",
        "required": [
          "query"
        ],
        "properties": {
          "limit": {
            "type": "number",
            "default": 50
          },
          "query": {
            "type": "string",
            "description": "Search terms (supports multiple words, e.g., 'budget report 2024')"
          },
          "basePath": {
            "type": "string",
            "default": "/"
          },
          "maxDepth": {
            "type": "number",
            "default": 3
          },
          "searchIn": {
            "type": "array",
            "items": {
              "enum": [
                "filename",
                "content",
                "metadata"
              ],
              "type": "string"
            },
            "default": [
              "filename",
              "content"
            ]
          },
          "dateRange": {
            "type": "object",
            "properties": {
              "to": {
                "type": "string"
              },
              "from": {
                "type": "string"
              }
            }
          },
          "fileTypes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "sizeRange": {
            "type": "object",
            "properties": {
              "max": {
                "type": "number"
              },
              "min": {
                "type": "number"
              }
            }
          },
          "quickSearch": {
            "type": "boolean",
            "default": true
          },
          "caseSensitive": {
            "type": "boolean",
            "default": false
          },
          "includeContent": {
            "type": "boolean",
            "default": false
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "path": {
                  "type": "string"
                },
                "size": {
                  "type": "number"
                },
                "mimeType": {
                  "type": "string"
                },
                "extension": {
                  "type": "string"
                },
                "matchType": {
                  "type": "string"
                },
                "highlights": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "isDirectory": {
                  "type": "boolean"
                },
                "lastModified": {
                  "type": "string"
                },
                "relevanceScore": {
                  "type": "number"
                }
              }
            }
          },
          "searchStats": {
            "type": "object",
            "properties": {
              "query": {
                "type": "string"
              },
              "basePath": {
                "type": "string"
              },
              "searchTime": {
                "type": "string"
              },
              "searchScope": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "totalResults": {
                "type": "number"
              },
              "searchDurationMs": {
                "type": "number"
              },
              "quickSearchEnabled": {
                "type": "boolean"
              }
            }
          }
        }
      }
    }
  ],
  "version": "1.0.0",
  "categories": [
    "notes",
    "calendar",
    "contacts",
    "tables",
    "webdav",
    "search"
  ],
  "description": "A Model Context Protocol (MCP) server for Nextcloud integration, providing 30+ tools for Notes, Calendar, Contacts, Tables, and WebDAV operations with advanced unified search capabilities"
}