Skip to main content
Glama
Billingo MCP Server

Billingo MCP Server

by Szotasz

Billingo MCP Server

An MCP (Model Context Protocol) server for the Billingo invoicing API (v3). This server enables AI assistants like Claude to manage invoices, partners, products, expenses, and more through natural language.

Magyar nyelvű dokumentáció lentebb / Hungarian docs below

Remote Usage (connectors.hu)

If you don't want to install locally, connectors.hu provides a unified access point to Billingo (and other Hungarian business APIs). connectors.hu handles authentication and exposes billingo_* namespaced tools to your AI agent (Claude Code, Claude Desktop, etc.).

Connect via connectors.hu


Related MCP server: invoiceninja-mcp

Features

  • Documents/Invoices — Create, list, cancel, copy, download PDF, send via email, manage payments, check NAV Online Szamla status

  • Partners — Create, update, delete and search customers/suppliers

  • Products — Manage your product/service catalog

  • Bank Accounts — CRUD operations for company bank accounts

  • Spending/Expenses — Track and manage business expenses

  • Document Export — Export invoices to Excel/CSV

  • Organization — Retrieve your company data

  • Utilities — Verify tax numbers via NAV, get MNB currency exchange rates, list document blocks

Available Tools (35+)

Category

Tools

Documents

list_documents, get_document, create_document, cancel_document, delete_draft, create_from_proforma, create_from_draft, create_modification_document, copy_document, download_document, get_document_public_url, send_document

Payments

get_payment, update_payment, delete_payment, get_online_szamla_status

Partners

list_partners, get_partner, create_partner, update_partner, delete_partner

Products

list_products, get_product, create_product, update_product, delete_product

Bank Accounts

list_bank_accounts, get_bank_account, create_bank_account, update_bank_account, delete_bank_account

Spending

list_spending, get_spending, create_spending, update_spending, delete_spending

Export

create_document_export, download_document_export

Organization

get_organization

Utilities

check_tax_number, get_currency_rates, list_document_blocks

Prerequisites

Local Installation

git clone https://github.com/Szotasz/billingo-mcp.git
cd billingo-mcp
npm install
npm run build

Configuration

Claude Code

Add to your ~/.claude/settings.json:

{
  "mcpServers": {
    "billingo": {
      "command": "node",
      "args": ["/path/to/billingo-mcp/dist/cli.js"],
      "env": {
        "BILLINGO_API_KEY": "your-billingo-api-key"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "billingo": {
      "command": "node",
      "args": ["/path/to/billingo-mcp/dist/cli.js"],
      "env": {
        "BILLINGO_API_KEY": "your-billingo-api-key"
      }
    }
  }
}

Usage Examples

Once configured, you can ask your AI assistant:

  • "List my invoices from last month"

  • "Create an invoice for partner X with 2 items"

  • "Download invoice #123 as PDF"

  • "Check the tax number 12345678"

  • "What is today's EUR/HUF exchange rate?"

  • "Show me unpaid invoices"

  • "Send invoice #456 to client@example.com"

Support

If you find this project useful, you can support the development:

Support on Donably

License

MIT


Billingo MCP Szerver (Magyar)

MCP (Model Context Protocol) szerver a Billingo számlázó API-hoz (v3). Ezzel a szerverrel AI asszisztensek (pl. Claude) természetes nyelven kezelhetik a számlákat, partnereket, termékeket, költségeket és egyéb számlázási feladatokat.

Távoli használat (connectors.hu)

Ha nem szeretnéd helyben telepíteni, a connectors.hu egységes hozzáférési pontot ad a Billingóhoz (és további magyar üzleti API-khoz). A connectors.hu kezeli a hitelesítést, és a billingo_* namespacelt tool-okat hozzáférhetővé teszi az AI ügynököd számára (Claude Code, Claude Desktop, stb.).

Csatlakozás a connectors.hu-n

Funkciók

  • Számlák/Bizonylatok — Létrehozás, listázás, sztornózás, másolás, PDF letöltés, e-mail küldés, fizetéskezelés, NAV Online Számla státusz

  • Partnerek — Ügyfelek/szállítók kezelése (CRUD + keresés)

  • Termékek — Termék/szolgáltatás katalógus kezelése

  • Bankszámlák — Céges bankszámlák kezelése

  • Költségek — Üzleti költségek rögzítése és kezelése

  • Dokumentum export — Számlák exportálása Excel/CSV formátumban

  • Szervezet — Cégadatok lekérése

  • Segédeszközök — NAV adószám-ellenőrzés, MNB árfolyamok, számlatömbök listázása

Előfeltételek

Helyi telepítés

git clone https://github.com/Szotasz/billingo-mcp.git
cd billingo-mcp
npm install
npm run build

Beállítás

Claude Code

Add hozzá a ~/.claude/settings.json fájlhoz:

{
  "mcpServers": {
    "billingo": {
      "command": "node",
      "args": ["/elérési/út/billingo-mcp/dist/cli.js"],
      "env": {
        "BILLINGO_API_KEY": "a-te-billingo-api-kulcsod"
      }
    }
  }
}

Claude Desktop

Add hozzá a Claude Desktop konfighoz (~/Library/Application Support/Claude/claude_desktop_config.json macOS-en):

{
  "mcpServers": {
    "billingo": {
      "command": "node",
      "args": ["/elérési/út/billingo-mcp/dist/cli.js"],
      "env": {
        "BILLINGO_API_KEY": "a-te-billingo-api-kulcsod"
      }
    }
  }
}

Használati példák

A beállítás után az AI asszisztensnek mondhatod:

  • "Listázd az elmúlt havi számláimat"

  • "Készíts egy számlát X partnernek 2 tétellel"

  • "Töltsd le a 123-as számlát PDF-ben"

  • "Ellenőrizd a 12345678 adószámot"

  • "Mi a mai EUR/HUF árfolyam?"

  • "Mutasd a kifizetetlen számlákat"

  • "Küldd el a 456-os számlát a ugyfel@pelda.hu címre"

Támogatás

Ha hasznosnak találtad ezt a projektet, támogathatod a fejlesztést:

Támogass a Donably-n

Licensz

MIT

Available Tools

42 tools
cancel_documentB
DestructiveIdempotent

Számla sztornózása

Inputs: document_id (required).

check_tax_numberA
Read-only

Adószám ellenőrzése a NAV rendszerében. Visszaadja a cég nevét és címét ha érvényes.

Inputs: tax_number (required).

copy_documentB

Számla másolása (új számla készítése egy meglévő alapján)

Inputs: document_id (required).

create_bank_accountB

Új bankszámla hozzáadása

Inputs: name (required), account_number (required), account_number_iban, swift, +1 more.

create_documentB

Új számla/bizonylat létrehozása. A type mező határozza meg a bizonylat típusát (invoice, proforma, draft, stb.).

Inputs: partner_id (required), block_id (required), type (required), fulfillment_date (required), +12 more.

create_document_exportA

Dokumentum export indítása (számlák exportálása CSV/Excel formátumban). Visszaadja az export ID-t, amit a download_document_export tool-lal lehet letölteni.

Inputs: start_date (required), end_date (required), document_type.

create_from_draftB

Piszkozatból végleges számla készítése

Inputs: document_id (required).

create_from_proformaA

Díjbekérőből (proforma) számla készítése

Inputs: document_id (required).

create_modification_documentA

Módosító bizonylat készítése egy meglévő számlához

Inputs: document_id (required), items (required), fulfillment_date (required), due_date (required), +1 more.

create_partnerB

Új partner (ügyfél/szállító) létrehozása

Inputs: name (required), address (required), emails, taxcode, +8 more.

create_productC

Új termék/szolgáltatás létrehozása

Inputs: name (required), unit_price (required), comment, currency, +6 more.

create_spendingC

Új költség rögzítése

Inputs: spending_date (required), due_date (required), payment_method (required), items (required), +7 more.

delete_bank_accountC
DestructiveIdempotent

Bankszámla törlése

Inputs: bank_account_id (required).

delete_draftA
DestructiveIdempotent

Piszkozat számla törlése (csak draft típusra működik)

Inputs: document_id (required).

delete_partnerD
DestructiveIdempotent

Partner törlése

Inputs: partner_id (required).

delete_paymentB
DestructiveIdempotent

Fizetési előzmény törlése

Inputs: document_id (required).

delete_productC
DestructiveIdempotent

Termék törlése

Inputs: product_id (required).

delete_spendingB
DestructiveIdempotent

Költség törlése

Inputs: spending_id (required).

download_documentB
Read-only

Számla PDF letöltése és mentése a megadott útvonalra

Inputs: document_id (required), output_path (required).

download_document_exportA
Read-only

Exportált dokumentum letöltése. Az export ID-t a create_document_export adja vissza. Pollozza a státuszt, amíg kész nem lesz, majd letölti a fájlt.

Inputs: export_id (required), output_path (required).

get_bank_accountA
Read-only

Bankszámla adatainak lekérése ID alapján

Inputs: bank_account_id (required).

get_currency_ratesC
Read-only

Aktuális MNB árfolyamok lekérése

Inputs: to (required), from, date.

get_documentA
Read-only

Számla/bizonylat részleteinek lekérése ID alapján

Inputs: document_id (required).

get_document_public_urlA
Read-only

Nyilvános letöltési link generálása egy számlához

Inputs: document_id (required).

get_online_szamla_statusC
Read-only

NAV Online Számla státusz lekérése egy számlához

Inputs: document_id (required).

get_organizationB
Read-only

Szervezet (saját cég) adatainak lekérése a Billingo-ból

Inputs: no named parameters.

get_partnerA
Read-only

Partner adatainak lekérése ID alapján

Inputs: partner_id (required).

get_paymentA
Read-only

Számla fizetési előzményeinek lekérése

Inputs: document_id (required).

get_productB
Read-only

Termék adatainak lekérése ID alapján

Inputs: product_id (required).

get_spendingB
Read-only

Költség adatainak lekérése ID alapján

Inputs: spending_id (required).

list_bank_accountsC
Read-only

Bankszámlák listázása

Inputs: no named parameters.

list_document_blocksA
Read-only

Dokumentum blokkok (számlatömbök) listázása. Számla létrehozásához szükséges a block_id.

Inputs: no named parameters.

list_documentsA
Read-only

Számlák/bizonylatok listázása szűrőkkel

Inputs: page, per_page, block_id, partner_id, +8 more.

list_partnersB
Read-only

Partnerek listázása szűrőkkel

Inputs: page, per_page, query.

list_productsB
Read-only

Termékek/szolgáltatások listázása

Inputs: page, per_page, query.

list_spendingB
Read-only

Költségek listázása szűrőkkel

Inputs: page, per_page, spending_date_from, spending_date_to, +3 more.

send_documentA

Számla küldése e-mailben a partnernek vagy megadott címekre

Inputs: document_id (required), emails.

update_bank_accountC
Idempotent

Bankszámla adatainak módosítása

Inputs: bank_account_id (required), name, account_number, account_number_iban, +2 more.

update_partnerC
Idempotent

Partner adatainak módosítása

Inputs: partner_id (required), name, address, emails, +7 more.

update_paymentC
Idempotent

Fizetés rögzítése egy számlához

Inputs: document_id (required), date (required), price (required), payment_method (required).

update_productC
Idempotent

Termék adatainak módosítása

Inputs: product_id (required), name, comment, currency, +7 more.

update_spendingB
Idempotent

Költség módosítása

Inputs: spending_id (required), partner_id, spending_date, due_date, +8 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 42 tools

    Disambiguation5/5

    Each tool targets a distinct operation or entity (e.g., documents, partners, products) with no overlap. Even document creation variants (new, from draft, from proforma) are clearly separated by purpose.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., create_document, delete_partner, download_document_export), making the API predictable and easy to navigate.

    Tool Count3/5

    42 tools is high, but it covers a broad billing domain with multiple entities and operations. While justifiable, it exceeds the typical recommended range for an MCP server.

    Completeness5/5

    The tool set covers full CRUD for all major entities (documents, partners, products, bank accounts, spendings, payments) plus additional operations like cancel, copy, send, export, tax check, and currency rates. No obvious gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for the Billingo V3 Hungarian invoicing API. Manage invoices, partners, products, spendings, and bank accounts from any MCP client.
      14 npm
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      MCP server for Invoice Ninja v5 API. Enables AI assistants to manage clients, invoices, quotes, payments, and time tracking through natural language.
      32
      22 npm
      2
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that connects Claude to FreshBooks, enabling reading and management of invoices, clients, expenses, projects, and time entries via natural language.
      1
      -