How do I use oblio-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@oblio-mcp create an invoice for client SC Test SRL for 1500 RON" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Oblio.eu accounting MCP Server (Unofficial)

MCP Server for the Oblio API, enabling Claude and other MCP-compatible platforms to interact with Oblio.eu accounting software.

Create invoices, manage documents, collect payments, query nomenclatures, and submit e-Factura to Romania's SPV system -- all through natural language.

Prerequisites

Node.js >= 22.0.0
Docker (optional)
An active Oblio.eu account with API access

Setup

Get your Oblio API credentials:
- Log in at oblio.eu
- Go to Setari > Date Cont
- Copy your email and API secret
- Note your company CIF (e.g. RO37311090)
Add to your Claude Desktop config or other AI tool (claude_desktop_config.json):

Using npx (coming soon)

Once the package is published to npm, no installation will be required:

{
  "mcpServers": {
    "oblio": {
      "command": "npx",
      "args": ["-y", "oblio-mcp"],
      "env": {
        "OBLIO_API_EMAIL": "your-email@example.com",
        "OBLIO_API_SECRET": "your-api-secret",
        "CIF": "your-company-cif"
      }
    }
  }
}

Using a local clone (recommended)

git clone https://github.com/valentinludu/oblio-mcp.git
cd oblio-mcp
npm install

Then add to your config:

{
  "mcpServers": {
    "oblio": {
      "command": "node",
      "args": ["/path/to/oblio-mcp/dist/index.js"],
      "env": {
        "OBLIO_API_EMAIL": "your-email@example.com",
        "OBLIO_API_SECRET": "your-api-secret",
        "CIF": "your-company-cif"
      }
    }
  }
}

Using Docker

docker build -t oblio-mcp .

{
  "mcpServers": {
    "oblio": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OBLIO_API_EMAIL",
        "-e",
        "OBLIO_API_SECRET",
        "-e",
        "CIF",
        "oblio-mcp"
      ],
      "env": {
        "OBLIO_API_EMAIL": "your-email@example.com",
        "OBLIO_API_SECRET": "your-api-secret",
        "CIF": "your-company-cif"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`OBLIO_API_EMAIL`	Yes	Your Oblio account email
`OBLIO_API_SECRET`	Yes	API secret from Oblio > Setari > Date Cont
`CIF`	No	Default company CIF. Can also be set at runtime via the `set_cif` tool

Tools

Document Management

Tool	Description
`create_document`	Creates an invoice (factura), proforma, or delivery notice (aviz). Requires client details, at least one product, a series name, and issue date. Returns the created document's series, number, and link.
`get_document`	Retrieves a single document by type, series name, and number. Returns document details, link, and payment history.
`list_documents`	Lists and filters documents with pagination. Supports filtering by series, date range, client, draft/cancelled/collected status. Returns up to 100 results per page.
`delete_document`	Permanently deletes a document. Only the last document in a series can be deleted. Optionally removes the associated payment.
`cancel_document`	Cancels (annuls) a document, marking it as void. The document remains in the system.
`restore_document`	Restores a previously cancelled document, making it active again.

Payments

Tool	Description
`collect_payment`	Records a payment against an existing invoice. Supports payment types: Chitanta, Bon fiscal, Ordin de plata, Card, CEC, and others. Defaults to the full invoice amount if value is omitted.

Nomenclatures (Reference Data)

Tool	Description
`get_nomenclatures`	Fetches reference data from Oblio. Types: `companies`, `clients`, `products`, `vat_rates`, `series`, `languages`, `management`. Results are paginated (max 250 per page).

e-Factura (SPV)

Tool	Description
`create_einvoice`	Submits an existing invoice to Romania's SPV system for e-Factura. Returns status code: 0=processing, 1=success, 2=errors, -1=not sent.
`get_einvoice_archive`	Downloads the e-Invoice archive (XML) from SPV for a previously submitted invoice.

Configuration

Tool	Description
`set_cif`	Sets the company CIF (tax ID) used for all subsequent API requests.
`get_cif`	Returns the currently configured company CIF.

Prompts

The server includes 28 prompt templates for common operations: creating documents, retrieving documents, cancelling/restoring/deleting documents, searching nomenclatures, collecting payments, listing invoices, and managing e-Factura submissions.

Troubleshooting

If you encounter issues:

Verify your Oblio account is active and has API access
Check that OBLIO_API_EMAIL and OBLIO_API_SECRET are correctly set
Ensure your company CIF is set (via CIF env var or the set_cif tool)
Confirm you have the necessary permissions for the operations you're performing

License

ISC

This server cannot be installed

F

license - not found

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

oblio-mcp