---
name: freelance-invoice
description: Generate professional invoice PDFs for freelancers with
  multi-currency and tax support.
---


# Invoice Generator

Generate professional invoice PDFs from structured data.

**Use when** creating invoices, billing clients, or generating payment documents.

## Requirements

- Node.js 18+ with Puppeteer, OR `wkhtmltopdf`
- No API keys needed

## Instructions

1. **Collect invoice details**:
   - **From**: Name, address, email, bank details, logo URL (optional)
   - **To**: Client name, address, email
   - **Items**: Description, quantity, unit price
   - **Meta**: Invoice number, date, due date, currency (default: USD), tax rate (default: 0%)
   - **Notes**: Payment terms, thank you message

2. **Generate HTML invoice** with this structure:
   - Header: sender info + logo, invoice number/date
   - Client info block
   - Line items table with columns: Description | Qty | Unit Price | Amount
   - Subtotal, tax (if applicable), **total** in bold
   - Footer: payment instructions, bank details, notes

3. **Convert to PDF**:
   ```bash
   # Option A: Puppeteer (best quality)
   node -e "
   const p=require('puppeteer');
   (async()=>{
     const b=await p.launch({args:['--no-sandbox']});
     const pg=await b.newPage();
     await pg.setContent(fs.readFileSync('invoice.html','utf8'));
     await pg.pdf({path:'invoice.pdf',format:'A4',margin:{top:'20mm',bottom:'20mm',left:'15mm',right:'15mm'}});
     await b.close();
   })()
   "

   # Option B: wkhtmltopdf
   wkhtmltopdf --margin-top 20mm --margin-bottom 20mm invoice.html invoice.pdf
   ```

4. **Currency formatting**:
   | Currency | Symbol | Format |
   |----------|--------|--------|
   | USD | $ | $1,234.56 |
   | EUR | € | €1.234,56 |
   | JPY | ¥ | ¥123,456 |
   | GBP | £ | £1,234.56 |

5. **Deliver**: Save PDF, provide file path. Offer to adjust formatting.

## Invoice Number Convention

- Sequential: `INV-2025-001`, `INV-2025-002`
- Date-based: `INV-20250115-01`
- Client-prefixed: `ACME-2025-003`

Suggest incrementing from the last used number.

## Edge Cases

- **No tax**: Set tax to 0% and hide the tax row.
- **Multiple tax rates**: Support line-item-level tax or split tax display.
- **Discount**: Add a discount line with negative amount before subtotal.
- **Recurring invoices**: Suggest a naming scheme and increment invoice numbers.
- **Missing Puppeteer**: Fall back to `wkhtmltopdf`. If neither available, output HTML only.

## Security Considerations

- Never embed real bank account details in example outputs.
- Invoice HTML should not load external resources (tracking pixels, scripts).
- Sanitize all user input before embedding in HTML to prevent XSS.


---
Source attribution: modbender
Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/freelance-invoice/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Dave AI.

## Upstream license notice

MIT License

Copyright (c) 2025 skill-library-mcp contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Dave AI resource metadata

Creator / publisher: modbender
Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/freelance-invoice/SKILL.md
Attribution basis: Source repository record

Fields of work: Sales
Roles: Account Executive, Business Development, Customer Success Manager, Sales Development Rep (SDR)
Specialties: API
Tools: Puppeteer, Wkhtmltopdf
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: d2096c5eeaa8662d4361c94409e80cb463b34582a4c7286cee0a6abd68d96541