Oblio
Issue and track Romanian invoices on Oblio from an AI assistant
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.1.2
- Listing updated
- 2 days ago
About Oblio
Oblio is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
Every tool that creates, changes or undoes a fiscal document is flagged as money. The assistant is expected to ask you first and to show the total worked out the way ANAF checks it. There is no sandbox, so an invoice issued through this server is real and takes the next number in its series.
The server acts on one company only. You give it a config file (app.json) holding your Oblio sign-in email, the API secret and the company's CIF, and no call can run against a company that file does not name. The README says the server only reads that file and that its errors name a bad field without printing a value.
It describes 17 tools. They read clients, products, series, VAT rates and issued invoices, and they issue invoices and proformas, record payments, and cancel, restore, reverse or delete invoices. The README suggests running the health check first, then listing series and VAT rates, since an invoice refers to both by the names Oblio gives them.
Install
Run in a terminal
claude mcp add oblio --env OBLIO_CONFIG='<OBLIO_CONFIG>' -- npx -y @foreverworks/mcp-oblioAdd to claude_desktop_config.json
{
"mcpServers": {
"oblio": {
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-oblio"
],
"env": {
"OBLIO_CONFIG": "<OBLIO_CONFIG>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"oblio": {
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-oblio"
],
"env": {
"OBLIO_CONFIG": "<OBLIO_CONFIG>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"oblio": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-oblio"
],
"env": {
"OBLIO_CONFIG": "<OBLIO_CONFIG>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"oblio": {
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-oblio"
],
"env": {
"OBLIO_CONFIG": "<OBLIO_CONFIG>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"oblio": {
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-oblio"
],
"env": {
"OBLIO_CONFIG": "<OBLIO_CONFIG>"
}
}
}
}Configuration
OBLIO_CONFIGPath of app.json: your Oblio login email, API secret and the company's CIF, as the README describes it.Required
What it does
- Invoices and proformas
- Issues invoices and proformas through Oblio's API, including turning a proforma into an invoice.
- Payment recording
- Records a payment against an invoice, for example a bank transfer in EUR.
- Cancel, reverse, delete
- Cancels, restores, reverses or deletes invoices, keeping recorded payments when asked.
- ANAF-style totals
- Shows the total computed the way ANAF checks it before a fiscal document is made.
- Single-company scope
- Acts only on the company CIF named in app.json.
- Health check
- Confirms the account, the CIF and whether the account reaches that company before anything is issued.
Good for
- Ask which September invoices are still unpaid
- Invoice a client for hours of consulting with VAT and a due date
- Record a client's payment on an existing invoice
- Convert a proforma into a final invoice
- Reverse an invoice while keeping its payment
Pricing
Open source
Runs locally via npm; needs an Oblio account (Oblio's own pricing not covered)
Prices change. Check foreverworks.github.io before you buy.
Oblio FAQ
Does it have a test mode?
No. The README says there is no sandbox, so an issued invoice is real and uses the next number in its series.
What do I need to set it up?
An Oblio account, its API secret, and the CIF of the company the server should act on, all placed in an app.json file.
Where do I find the API secret?
In the Oblio web app under Settings, Account Data. Oblio makes a new secret each time the account password is reset.
Which Node version does it need?
Node 22.19 or newer.
Is Oblio free?
Yes. Oblio is open source, so you can use and self-host it for free.
How do I add Oblio to Claude Code?
Run this command in your terminal: claude mcp add oblio --env OBLIO_CONFIG='<OBLIO_CONFIG>' -- npx -y @foreverworks/mcp-oblio
What are the best alternatives to Oblio?
The closest alternatives to Oblio are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.
Alternatives to Oblio

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government