Skip to content
MCP server

Numerador de facturas

Stamp sequential invoice numbers onto batches of PDFs on your own computer

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.1
Listing updated
3 days ago

About Numerador de facturas

Numerador de facturas is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "numerador-facturas": {
      "command": "npx",
      "args": [
        "-y",
        "numerador-facturas-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "numerador-facturas": {
      "command": "npx",
      "args": [
        "-y",
        "numerador-facturas-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

MIT licence

Prices change. Check nuncaeslupus.github.io before you buy.

Numerador de facturas 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 to Numerador de facturas

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents