Content
# Blank Invoice Maker — MCP Server
An [MCP](https://modelcontextprotocol.io) server that lets any AI assistant (Claude, and other MCP clients) create invoices with **[Blank Invoice Maker](https://blankinvoicemaker.com)** — the free, no-signup, no-watermark invoice generator.
Ask your assistant to make an invoice, and it returns a link that opens **[blankinvoicemaker.com](https://blankinvoicemaker.com)** with the invoice fully pre-filled, ready to review and download as a PDF.
> **Privacy by design.** The invoice data travels inside the link's URL fragment (`#invoice=…`) and is decoded entirely in your browser. Nothing is uploaded — consistent with Blank Invoice Maker's no-account, no-server-storage model.
## Tools
| Tool | What it does |
| --- | --- |
| `list_templates` | Lists the industry invoice templates available at [blankinvoicemaker.com/templates](https://blankinvoicemaker.com/templates) (slug, name, description, URL). |
| `create_invoice` | Builds an invoice from your details and returns a pre-filled [blankinvoicemaker.com](https://blankinvoicemaker.com) link to review and download. |
### `create_invoice` example
> *"Invoice Globex LLC for 10 hours of design at $90/hr and one $120 hosting setup, net 14, in GBP."*
The assistant calls `create_invoice` with:
```json
{
"business": { "name": "Acme Studio", "email": "hi@acme.studio" },
"client": { "name": "Globex LLC", "email": "ap@globex.com" },
"items": [
{ "description": "Design work", "quantity": 10, "unitPrice": 90, "unit": "hours" },
{ "description": "Hosting setup", "quantity": 1, "unitPrice": 120 }
],
"currency": "GBP",
"paymentTerms": "Net 14"
}
```
…and returns a `https://blankinvoicemaker.com/#invoice=…` link that opens the editor pre-filled.
## Installation
Requires Node.js 18+.
### Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"blank-invoice-maker": {
"command": "npx",
"args": ["-y", "blank-invoice-maker-mcp"]
}
}
}
```
### Other MCP clients
Run the server over stdio:
```bash
npx -y blank-invoice-maker-mcp
```
## How it works
`create_invoice` maps your input into the invoice structure used by [blankinvoicemaker.com](https://blankinvoicemaker.com), compresses it with [`lz-string`](https://github.com/pieroxy/lz-string), and appends it to the site URL as a `#invoice=` fragment. Opening the link hydrates the editor in your browser — no signup, no watermark, no data leaving your machine.
## Development
```bash
npm install
npm run build # compile TypeScript to dist/
npm test # build + run the unit tests
npm start # run the server over stdio
```
### Keeping templates in sync
`src/templates-data.ts` is generated from the Blank Invoice Maker template registry:
```bash
BIM_APP_DIR=/path/to/blank-invoice-maker npm run generate:templates
```
## Links
- **App:** https://blankinvoicemaker.com
- **Templates:** https://blankinvoicemaker.com/templates
- **Model Context Protocol:** https://modelcontextprotocol.io
## License
[MIT](./LICENSE) © [Blank Invoice Maker](https://blankinvoicemaker.com)
