holded-skill
by jaumecornado
Search & ResearchBrief
Operate Holded ERP through holdedcli to read and update data safely.
Description
What This Skill Does
Interact with Holded ERP from the terminal using holdedcli. Covers contacts, invoices, products, CRM, projects, team management, and accounting. Enforces a mandatory confirmation step before any write operation to prevent accidental data changes.
Wraps Holded's REST API in a discoverable CLI with built-in parameter validation and explicit confirmation prompts, which reduces accidental writes compared to calling the API directly with curl.
When to Use It
- Look up a contact's invoice history without opening the Holded web app
- Create a purchase receipt with correct Spanish IVA deductibility rules applied
- Update a product price or stock quantity from the command line
- Search CRM deals or projects by filter across a Holded account
- Audit accounting entries by running batch read queries against the API
Example Workflow
User asks: Create a purchase receipt for a restaurant meal on 11/02/2026 for 29.40 EUR
- 1
Run
holded actions list --filter invoice --jsonto locate the create-document action - 2
Run
holded actions describe invoice.create-document --jsonto verify accepted parameters - 3
Check Spanish accounting rules: restaurant IVA is not deductible, so set tax to 0 and use account 629
- 4
Calculate the Unix timestamp for 11/02/2026 00:00 in Europe/Madrid timezone using Python
- 5
Show the exact command with
docType=purchase,isReceipt: true, and--skip-validation, then wait for explicit confirmation before running
Purchase receipt created in Holded with HTTP 200 and the new document ID returned
Requirements
- HOLDED_API_KEY environment variable
- Holded account
Installation
clawhub install jaumecornado/holded-skillRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.