# Oblio

Issues and tracks Romanian fiscal invoices through the Oblio API. Computes totals according to ANAF rules directly in AI coding assistants.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: foreverworks
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/foreverworks/mcps/tree/HEAD/servers/oblio
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/oblio

## What it does

This MCP server links your coding agent to the Oblio invoicing platform. It pulls saved records of clients, products, series, and VAT percentages. From your chat, the server can issue invoices or proformas, log bank payments, and manage cancellations or reversals.

Every fiscal action has real-world consequences. There is no sandbox mode, meaning each generated invoice takes the subsequent official number in its assigned series. Because of this, document-altering actions prompt for explicit confirmation and display the computed fiscal total beforehand.

Running the package requires Node 22.19 or higher. Authentication relies on an `app.json` file specified via `OBLIO_CONFIG`, which must contain the login email, the API secret, and the company's CIF.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `OBLIO_CONFIG` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add oblio -e OBLIO_CONFIG=<OBLIO_CONFIG> -- npx -y @foreverworks/mcp-oblio
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add oblio --env OBLIO_CONFIG=<OBLIO_CONFIG> -- npx -y @foreverworks/mcp-oblio
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "oblio": {
            "command": "npx",
            "args": [
                "-y",
                "@foreverworks/mcp-oblio"
            ],
            "env": {
                "OBLIO_CONFIG": "<OBLIO_CONFIG>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "oblio": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@foreverworks/mcp-oblio"
            ],
            "env": {
                "OBLIO_CONFIG": "<OBLIO_CONFIG>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e OBLIO_CONFIG=<OBLIO_CONFIG> oblio npx -y @foreverworks/mcp-oblio
```
Replace <…> with your own values

## When to use it
- issue fiscal invoices and proformas for Romanian entities
- track unpaid customer invoices by date and series
- log bank transfer payments against issued documents
- reverse or cancel existing fiscal records

## Example prompts
- Which invoices from September are still unpaid?
- Create an invoice for Client SRL for 8 hours of consulting at 1000 RON an hour plus 21% VAT.
- Record today's payment of 1000 EUR on invoice FCT 0042 received by bank transfer.

## Similar
- [HowToRomania](https://affpapa.org/en/nevibecode/mcp/howtoromania.md) — MCP server
- [Kash — POS, Invoicing, CRM & Webshop](https://affpapa.org/en/nevibecode/mcp/kash-pos-invoicing-crm-webshop.md) — MCP server · 2880 installs
- [Hellobooks](https://affpapa.org/en/nevibecode/mcp/hellobooks.md) — MCP server · 1748 installs
- [revuo](https://affpapa.org/en/nevibecode/mcp/revuo.md) — MCP server · 943 installs
- [billing-automation](https://affpapa.org/en/nevibecode/skills/billing-automation.md) — skill · 11245 installs
- [connector-quickbooks](https://affpapa.org/en/nevibecode/skills/connector-quickbooks.md) — skill · 10200 installs

From the same set: [foreverworks/mcps](https://affpapa.org/en/nevibecode/by/foreverworks/mcps.md) — 15 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
