Oblio — Claude Code MCP server: what it does, how to install
Issues and tracks Romanian fiscal invoices through the Oblio API. Computes totals according to ANAF rules directly in AI coding assistants.
MIT ★ 5 updated 2026-10-29
claude mcp add oblio -e OBLIO_CONFIG=<OBLIO_CONFIG> -- npx -y @foreverworks/mcp-oblioWhat Oblio 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.
What it helps with
- 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 for the agent
- 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.
How to install Oblio
Platform CLI
claude mcp add oblio -e OBLIO_CONFIG=<OBLIO_CONFIG> -- npx -y @foreverworks/mcp-oblioReplace <…> with your own values
Platform CLI
codex mcp add oblio --env OBLIO_CONFIG=<OBLIO_CONFIG> -- npx -y @foreverworks/mcp-oblioReplace <…> with your own values
Config file
{
"mcpServers": {
"oblio": {
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-oblio"
],
"env": {
"OBLIO_CONFIG": "<OBLIO_CONFIG>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"oblio": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-oblio"
],
"env": {
"OBLIO_CONFIG": "<OBLIO_CONFIG>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e OBLIO_CONFIG=<OBLIO_CONFIG> oblio npx -y @foreverworks/mcp-oblioReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Oblio
How to install Oblio in Claude Code?
Run claude mcp add oblio -e OBLIO_CONFIG=<OBLIO_CONFIG> -- npx -y @foreverworks/mcp-oblio. Replace <OBLIO_CONFIG> with the absolute path to your app.json credentials file.
What does the Oblio MCP server do?
It connects your AI tools to the Oblio API to manage Romanian invoicing, monitor e-Factura states, and track incoming payments.
Is there a test sandbox available?
No sandbox exists in this integration. Every created invoice is legally issued and takes the next number in the fiscal series.