Numerador de facturas
Stamp sequential invoice numbers onto batches of PDFs on your own computer
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"numerador-facturas": {
"command": "npx",
"args": [
"-y",
"numerador-facturas-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"numerador-facturas": {
"command": "npx",
"args": [
"-y",
"numerador-facturas-mcp"
]
}
}
}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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

CARTESIAN ECU
MCP serverCheck and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)
Not checked yet- 5 tools
- Remote
- Paid
- Files and documents