Holded Invoices
Apps & Automationholded-invoicesHolded Invoices is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Process invoice emails: download PDF attachments, extract vendor + date, generate normalized filename, and send to Holded inbox via n8n webhook.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/productivity/holded-invoices/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/holded-invoices, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Holded invoices (Gmail → PDF → n8n webhook → Holded inbox)
Goal: when an email contains an invoice PDF, upload it to Holded via an n8n webhook.
Destinations
Configure defaults in ~/.config/skills/config.json under holded_invoices:
company_emailfreelancer_emailwebhook
Example:
{
"holded_invoices": {
"company_email": "[email protected]",
"freelancer_email": "[email protected]",
"webhook": "https://n8n.example.com/webhook/..."
}
}
Webhook fields:
email(Holded inbox) (HTTP header)nombre(base filename, without extension) (HTTP header)- Body: raw PDF (
Content-Type: application/pdf)
Filename convention:
<company>-<YYYY>-<MM>.pdf- Vendor slug: lowercased, spaces → dashes, simplified (e.g. "Google INC" →
google).
Scripts
1) Extract vendor + date from a PDF
scripts/invoice-extract.js --pdf /path/to/invoice.pdf- Outputs JSON:
{ vendor, vendorSlug, year, month }
- Outputs JSON:
2) Upload a PDF to Holded via n8n
scripts/holded-upload.sh --pdf /path/to/invoice.pdf --email <holdedbox> --nombre google-2026-01.pdf- If not configured, pass
--webhookexplicitly.
- If not configured, pass
3) End-to-end: from a Gmail message ID
Downloads the first PDF attachment, suggests a filename, and (optionally) uploads.
scripts/holded-from-gmail.sh --account <gmail-account> --message-id <id> --type empresa|autonomo- If not configured, pass
--email-empresa,--email-autonomo, and/or--webhook.
- If not configured, pass
Flags:
--yesskip confirmation and upload
Agent workflow
When reviewing an email thread with a PDF invoice:
- Ask: is it
empresaorautonomo. - Download the PDF attachment.
- Run
invoice-extract.jsto infer vendor + year/month. - Propose filename and ask for confirmation.
- Call webhook via
holded-upload.sh.
If extraction fails, ask for vendor + date and continue.