# Oblio

> Oblio is an open-source MCP server for finance and payments. Issue and track Romanian invoices on Oblio from an AI assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://foreverworks.github.io/mcps/servers/oblio/
- **Repository:** https://github.com/foreverworks/mcps/tree/HEAD/servers/oblio
- **MCP Registry name:** com.foreverworks/oblio
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add oblio --env OBLIO_CONFIG='<OBLIO_CONFIG>' -- npx -y @foreverworks/mcp-oblio
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "oblio": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-oblio"
      ],
      "env": {
        "OBLIO_CONFIG": "<OBLIO_CONFIG>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "oblio": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-oblio"
      ],
      "env": {
        "OBLIO_CONFIG": "<OBLIO_CONFIG>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "oblio": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-oblio"
      ],
      "env": {
        "OBLIO_CONFIG": "<OBLIO_CONFIG>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "oblio": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-oblio"
      ],
      "env": {
        "OBLIO_CONFIG": "<OBLIO_CONFIG>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "oblio": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-oblio"
      ],
      "env": {
        "OBLIO_CONFIG": "<OBLIO_CONFIG>"
      }
    }
  }
}
```

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/oblio
