# Numerador de facturas

> Numerador de facturas is an open-source MCP server for files and documents. Stamp sequential invoice numbers onto batches of PDFs on your own computer. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://nuncaeslupus.github.io/numerador-facturas/
- **Repository:** https://github.com/nuncaeslupus/numerador-facturas/tree/HEAD/mcp
- **MCP Registry name:** io.github.nuncaeslupus/numerador-facturas
- **Categories:** files and documents, productivity
- **Listing updated:** 2026-11-14

## About

Everything runs locally as a process on your machine, so the model passes file paths rather than invoice contents, and only receives the list of generated files back. There is no account and no network access during numbering. Originals are never modified; numbered copies are written alongside. If you ask the model to read an invoice itself, that text does pass through your LLM provider.

The single tool, `number_invoices`, accepts the same options as the sister web app: template, start or end number, order, position, font, box, merged PDF and ZIP output. A `dry_run` flag shows the numbering without writing anything. A request such as numbering a folder starting from F-0500 works in plain language.

It is deliberately strict to avoid gaps in a series. If any file is password-protected, damaged or incomplete, none are numbered. It will not overwrite existing files and deletes partial output if writing fails. It rejects positions outside a page but does not check that the number fits fully, and copies of protected PDFs come out without a password. Needs Node 20 or later; installs as a Claude Desktop extension or through npx.

## Features

- **Batch numbering:** Stamps F-0001, F-0002 and so on on every page of each invoice.
- **Offline and private:** Runs locally with no network requests; the model sees paths, not PDF contents.
- **Dry run:** Preview the numbering sequence without writing files.
- **Gap-safe batches:** Refuses the whole batch if any file is protected or damaged.
- **Output options:** Choose position, font, box, merged PDF or ZIP output.
- **Non-destructive:** Writes copies, never overwrites existing files, and cleans up on write failure.

## Good for

- Number a folder of invoices starting from a chosen value
- Preview a numbering run before writing files
- Produce a merged PDF of numbered invoices
- Keep invoice contents off the AI provider while still automating stamping

## Install

### Claude Code (Terminal)

```sh
claude mcp add numerador-facturas -- npx -y numerador-facturas-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "numerador-facturas": {
      "command": "npx",
      "args": [
        "-y",
        "numerador-facturas-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "numerador-facturas": {
      "command": "npx",
      "args": [
        "-y",
        "numerador-facturas-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "numerador-facturas": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "numerador-facturas-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "numerador-facturas": {
      "command": "npx",
      "args": [
        "-y",
        "numerador-facturas-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "numerador-facturas": {
      "command": "npx",
      "args": [
        "-y",
        "numerador-facturas-mcp"
      ]
    }
  }
}
```

## Tools

- `number_invoices`: Stamps sequential numbers on batches of PDF invoices and writes numbered copies, with an optional dry run.

## FAQ

### Do my invoices get uploaded anywhere?

No. The server runs locally, makes no network requests, and the model only receives file paths and the list of generated files.

### Are original PDFs changed?

No. Numbered copies are written and originals stay as they are.

### What happens if one PDF is damaged?

None of the batch is numbered, so the series has no gaps.

### What do I need to run it?

Node 20 or higher, via npx or the Claude Desktop extension.

### Is Numerador de facturas free?

Yes. Numerador de facturas is open source, so you can use and self-host it for free.

### How do I add Numerador de facturas to Claude Code?

Run this command in your terminal: claude mcp add numerador-facturas -- npx -y numerador-facturas-mcp

### What are the best alternatives to Numerador de facturas?

The closest alternatives to Numerador de facturas are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/numerador-de-facturas
