OpenParable
Skip to content
← Back to skills

Holded Invoices

Apps & Automation
holded-invoices

Holded 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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_email
  • freelancer_email
  • webhook

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 }

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 --webhook explicitly.

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.

Flags:

  • --yes skip confirmation and upload

Agent workflow

When reviewing an email thread with a PDF invoice:

  1. Ask: is it empresa or autonomo.
  2. Download the PDF attachment.
  3. Run invoice-extract.js to infer vendor + year/month.
  4. Propose filename and ask for confirmation.
  5. Call webhook via holded-upload.sh.

If extraction fails, ask for vendor + date and continue.