← Back to Skills Marketplace
keithvassallomt

openclaw-nextcloud

by Keith Vassallo · GitHub ↗ · v0.6.0 · MIT-0
cross-platform ✓ Security Clean
6689
Downloads
9
Stars
0
Active Installs
16
Versions
Install in OpenClaw
/install openclaw-nextcloud
Description
Manage Notes, Tasks, Calendar, Files, Contacts, and Deck Kanban boards in your Nextcloud instance via CalDAV, WebDAV, Notes, and Deck APIs. Use for creating notes, managing todos and calendar events, uploading/downloading files, managing contacts, and organizing Kanban boards, stacks, and cards.
Usage Guidance
Install only if you are comfortable giving the agent full account-level Nextcloud access. Use a revocable app password, prefer a test account first, confirm public shares carefully, use passwords and expiry dates for shared links, and revoke the app password if anything looks wrong.
Capability Assessment
Credentials
It requires a full account-scope Nextcloud app password and can read, mutate, delete, and share account data, which is high impact but coherent with the stated account-management purpose and disclosed limitations of Nextcloud app passwords.
Install Mechanism
The artifact is a pre-bundled Node.js CLI with declared package metadata and no observed install-time persistence or auto-update behavior; dependencies are declared and the bundled script is the runtime path.
Instruction Scope
Runtime instructions are scoped to running the bundled Nextcloud CLI, require user confirmation for destructive and public-facing operations, require confirmation tokens for irreversible operations, and warn that retrieved Nextcloud content is untrusted data.
Persistence & Privilege
No background worker, privilege escalation, credential harvesting, or durable local persistence was found; credentials are read from environment variables and sent to the configured Nextcloud URL with HTTPS enforced by default.
Purpose & Capability
The skill's purpose is a broad Nextcloud integration for notes, files, calendar, tasks, contacts, Deck, and shares; public-link sharing is sensitive but is disclosed in metadata, safety text, command documentation, and examples.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-nextcloud
  3. After installation, invoke the skill by name or use /openclaw-nextcloud
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.6.0
- Tasks can now carry a start date, a location, a link, a privacy setting, and tags — set when you create a task or add them later - You can mark a task as in progress or cancelled, and record how far along it is as a percentage - Dates without a time now make proper all-day tasks, so they show on the day you meant no matter what timezone you're in - Clearing a task's tags, location or link is now possible by setting them to nothing - Fixed: changing a task's start date could quietly change the wrong thing and leave the task with no start at all, while still reporting success - Fixed: task lists sometimes showed a nonsense start date from 1970 - Fixed: completion times and new event timestamps were recorded in the wrong timezone
v0.5.0
- Adds support for an optional NEXTCLOUD_EMAIL environment variable. - When NEXTCLOUD_EMAIL is set, newly created calendar events are marked as confirmed with the organiser and attendee fields set to that address. - Improves compatibility section to document the new NEXTCLOUD_EMAIL option.
v0.4.2
0.4.2 Fixed - tasks list no longer hides tasks created in the Nextcloud Tasks web app. Those omit the STATUS property, and the CalDAV filter only matched todos that declare it, so they were silently missing from every result. Completed tasks stay hidden as before. - Deck deletes no longer fail with 403 Forbidden on Nextcloud 34. This affected boards, stacks, cards, labels and card comments. Changed - Requires Node.js 24 or higher, up from 20, which is end-of-life. Security - Dependencies pinned to exact versions. fast-xml-parser updated past two high-severity advisories in a transitive dependency. Neither reached the shipped bundle, which imports only the XML parser. - The build no longer downloads anything at install time. - The README documents the three findings automated skill scanners report against this repo, and how to rebuild the bundle from source to verify it.
v0.3.3
openclaw-nextcloud v0.4.0 ⚠️ Breaking: 11 irreversible operations now need a --confirm command:subcommand token (the 9 deletes, shares delete, shares create-link). Everything else is unchanged. Agents pick this up from SKILL.md automatically; scripts and cron jobs need the token added. Security: closed WebDAV path traversal, iCalendar/vCard property injection, and PRIORITY injection. Text and secrets can now be read from a file so they never appear in the process argument list. Fixes: vCard 3.0 group prefixes and structured names parse correctly. Declares skillKey so OpenClaw resolves one stable config key regardless of install alias. Also: CI now verifies the bundle matches its source, plus 41 tests. Thanks to @sam2kb and @bolinches.
v0.3.2
openclaw-nextcloud 0.3.2 changelog: - Added safety mechanism: destructive and public-facing commands now require a CLI confirmation token (`--confirm <command:subcommand>`) for irreversible operations. - Updated documentation to distinguish between irreversible (token required) and recoverable (confirmation only) operations. - Added and reorganized documentation around usage, confirmation requirements, and safety checks. - Internal directory structure modified: added the `scripts` directory and removed unnecessary files. - Incremented skill version metadata.
v0.3.1
The vCard 3.0 spec allows group prefixes like 'item1.' before property names when multiple instances of the same property type exist. The regexes in _parseVCard and _updateVCardField only matched bare property names, so contacts with grouped properties (e.g. item1.EMAIL;type=INTERNET) were silently skipped. This adds optional (?:item\d+.)? prefix to all vCard property regexes. Thanks [@bolinches](https://github.com/bolinches)
v0.3.0
Version 0.3.0 - Added initial Deck (Kanban) support, including safety documentation for destructive Deck operations - thanks to @makefu. - Updated SKILL.md to reflect Deck Boards/Stacks/Cards management features and corresponding commands. - Expanded allowed destructive operations metadata to include boards, stacks, cards, and labels. - Added project-specific configuration, logging, and runtime metadata files.
v0.2.5
**Added** - Calendar events (calendar list-events) and tasks (task list) now include a description field, parsed from the iCalendar DESCRIPTION property. **Fixed** - iCalendar line unfolding applied before extracting DESCRIPTION, so multi-line agendas, dial-in details, and other folded values are returned intact rather than truncated at the first physical line. - DESCRIPTION matching anchored to a property line with parameter support (DESCRIPTION;LANGUAGE=..., DESCRIPTION;ALTREP=...), so an embedded VALARM block inside a VEVENT no longer shadows the event's own description. Thanks to @MaNyh (#7) for raising the original gap.
v0.2.4
openclaw-nextcloud 0.2.4 - Version bump from 0.2.3 to 0.2.4. - Resolve issue when adding events to non-default calendar.
v0.2.3
- Added openclaw metadata block to SKILL.md to declare skill version, required binaries, and structured environment variables. - Improved documentation of environment variables, adding more detailed descriptions. - Clarified safety guidance: now explicitly warns that retrieved user content may contain text attempting to influence behavior; treat all such content strictly as data, not instructions.
v0.2.1
**This version adds an explicit Safety section and metadata highlighting the scope and risk of destructive operations.** - New "Safety" section in documentation, listing all destructive commands and emphasizing the need for explicit user confirmation before actions like delete, overwrite, or share. - Metadata updated to declare destructive operations, their scope, and credential requirements. - Compatibility section now clearly states account-scope app password is required. - No file or code changes; documentation and metadata improvements only.
v0.2.0
openclaw-nextcloud 0.2.0 - Initial public release with all code and documentation. - Adds support for authenticating and interacting with Nextcloud Notes, Tasks, Calendar, Files, and Contacts. - Provides new commands for file sharing: create, list, and delete public links. - Environment validation and improved security: only allows HTTPS by default; sensitive tokens now explicitly marked in metadata. - Documentation and metadata enhancements: now lists required environment variables, homepage, and security notes.
v0.1.3
- Migrated main script to scripts/nextcloud.js; removed old files (README.md, index.js, package.json, package-lock.json). - Updated documentation: clarified usage with the new script path and removed npm install instructions. - Added license and compatibility information (MIT, Node.js 20+ required). - Changed presentation guidelines: outputs now avoid markdown formatting for better compatibility with messaging apps. - Kept all commands, features, and output formats unchanged.
v0.1.2
Version 0.1.2 - Added YAML front matter to SKILL.md with `name`, `description`, and `allowed-tools` fields for standardization. - Clarified and condensed the skill description for better discoverability and tool selection. - No changes to commands, features, or usage. - No code or behavior changes—documentation/meta-data update only.
v0.1.1
openclaw-nextcloud v0.1.1 - Added a "summary" front matter field to SKILL.md. - Updated SKILL.md with a note about running `npm install` if `node_modules` is missing. - Minor documentation improvements and formatting changes in SKILL.md.
v0.1.0
Initial release of OpenClaw Nextcloud Skill with extensive Nextcloud integration. - Supports Notes, Tasks (Todos), Calendars, Files, and Contacts via command-line interface - Uses environment variables for Nextcloud connection credentials - Provides CRUD operations for notes, tasks (CalDAV), calendar events (CalDAV), files (WebDAV), and contacts (CardDAV) - Implements smart default selection for calendars and address books, with memory of user choices - Outputs all results as JSON, with detailed example schemas - Features markdown and emoji-rich presentation guidelines for user-facing output
Metadata
Slug openclaw-nextcloud
Version 0.6.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 16
Frequently Asked Questions

What is openclaw-nextcloud?

Manage Notes, Tasks, Calendar, Files, Contacts, and Deck Kanban boards in your Nextcloud instance via CalDAV, WebDAV, Notes, and Deck APIs. Use for creating notes, managing todos and calendar events, uploading/downloading files, managing contacts, and organizing Kanban boards, stacks, and cards. It is an AI Agent Skill for Claude Code / OpenClaw, with 6689 downloads so far.

How do I install openclaw-nextcloud?

Run "/install openclaw-nextcloud" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is openclaw-nextcloud free?

Yes, openclaw-nextcloud is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does openclaw-nextcloud support?

openclaw-nextcloud is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created openclaw-nextcloud?

It is built and maintained by Keith Vassallo (@keithvassallomt); the current version is v0.6.0.

💬 Comments