Skip to content
MCP server

Oblio

Issue and track Romanian invoices on Oblio from an AI assistant

Runs locallyStatus and history
Install
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-oblio

Add 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

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government