nextcloud-files
by romain-grosos
Web & Frontend DevelopmentBrief
Nextcloud file and folder management via WebDAV + OCS API.
Description
What This Skill Does
Manages files and folders on a Nextcloud instance via WebDAV and OCS API. Supports creating, reading, writing, renaming, moving, copying, deleting, listing, and searching files. Also handles favorites, system tags, and storage quota checks.
Uses only Python stdlib with no external dependencies, so it works in any Python 3.9+ environment without installing packages.
When to Use It
- Saving AI-generated article summaries as Markdown files to Nextcloud
- Appending daily entries to a running log file on Nextcloud
- Organizing a workspace by creating structured folder hierarchies
- Tagging files by status such as draft, published, or research
- Checking available storage quota before starting a large upload
Example Workflow
User asks: Save this article summary to my Nextcloud drafts folder
- 1
Connects to Nextcloud using NC_URL, NC_USER, and NC_APP_KEY credentials
- 2
Verifies the /Drafts folder exists within the configured base_path
- 3
Writes the summary content as /Drafts/summary.md
- 4
Confirms the file was created and returns its path
File saved to /Drafts/summary.md on Nextcloud
Requirements
- Nextcloud account (self-hosted or provider-hosted instance)
- NC_URL environment variable (Nextcloud instance URL)
- NC_USER environment variable (Nextcloud username)
- NC_APP_KEY environment variable (app password from Nextcloud Settings -> Security -> App passwords)
Installation
clawhub install romain-grosos/nextcloud-filesRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.