Billingo MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Billingo MCP Server List my unpaid invoices"
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.
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.).
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 |
|
Payments |
|
Partners |
|
Products |
|
Bank Accounts |
|
Spending |
|
Export |
|
Organization |
|
Utilities |
|
Prerequisites
Node.js 18+
A Billingo account with an API v3 key (generate one here)
Local Installation
git clone https://github.com/Szotasz/billingo-mcp.git
cd billingo-mcp
npm install
npm run buildConfiguration
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:
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.).
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
Node.js 18+
Billingo fiók API v3 kulccsal (generálás itt)
Helyi telepítés
git clone https://github.com/Szotasz/billingo-mcp.git
cd billingo-mcp
npm install
npm run buildBeá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:
Licensz
MIT
Available Tools
42 toolscancel_documentBDestructiveIdempotent
Számla sztornózása
Inputs: document_id (required).
check_tax_numberARead-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_accountCDestructiveIdempotent
Bankszámla törlése
Inputs: bank_account_id (required).
delete_draftADestructiveIdempotent
Piszkozat számla törlése (csak draft típusra működik)
Inputs: document_id (required).
delete_partnerDDestructiveIdempotent
Partner törlése
Inputs: partner_id (required).
delete_paymentBDestructiveIdempotent
Fizetési előzmény törlése
Inputs: document_id (required).
delete_productCDestructiveIdempotent
Termék törlése
Inputs: product_id (required).
delete_spendingBDestructiveIdempotent
Költség törlése
Inputs: spending_id (required).
download_documentBRead-only
Számla PDF letöltése és mentése a megadott útvonalra
Inputs: document_id (required), output_path (required).
download_document_exportARead-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_accountARead-only
Bankszámla adatainak lekérése ID alapján
Inputs: bank_account_id (required).
get_currency_ratesCRead-only
Aktuális MNB árfolyamok lekérése
Inputs: to (required), from, date.
get_documentARead-only
Számla/bizonylat részleteinek lekérése ID alapján
Inputs: document_id (required).
get_document_public_urlARead-only
Nyilvános letöltési link generálása egy számlához
Inputs: document_id (required).
get_online_szamla_statusCRead-only
NAV Online Számla státusz lekérése egy számlához
Inputs: document_id (required).
get_organizationBRead-only
Szervezet (saját cég) adatainak lekérése a Billingo-ból
Inputs: no named parameters.
get_partnerARead-only
Partner adatainak lekérése ID alapján
Inputs: partner_id (required).
get_paymentARead-only
Számla fizetési előzményeinek lekérése
Inputs: document_id (required).
get_productBRead-only
Termék adatainak lekérése ID alapján
Inputs: product_id (required).
get_spendingBRead-only
Költség adatainak lekérése ID alapján
Inputs: spending_id (required).
list_bank_accountsCRead-only
Bankszámlák listázása
Inputs: no named parameters.
list_document_blocksARead-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_documentsARead-only
Számlák/bizonylatok listázása szűrőkkel
Inputs: page, per_page, block_id, partner_id, +8 more.
list_partnersBRead-only
Partnerek listázása szűrőkkel
Inputs: page, per_page, query.
list_productsBRead-only
Termékek/szolgáltatások listázása
Inputs: page, per_page, query.
list_spendingBRead-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_accountCIdempotent
Bankszámla adatainak módosítása
Inputs: bank_account_id (required), name, account_number, account_number_iban, +2 more.
update_partnerCIdempotent
Partner adatainak módosítása
Inputs: partner_id (required), name, address, emails, +7 more.
update_paymentCIdempotent
Fizetés rögzítése egy számlához
Inputs: document_id (required), date (required), price (required), payment_method (required).
update_productCIdempotent
Termék adatainak módosítása
Inputs: product_id (required), name, comment, currency, +7 more.
update_spendingBIdempotent
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
Scored across 42 tools
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.
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.
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.
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
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Számlázz.hu MCP server for ChatGPT, Claude and any AI agent: issue invoice, cancel invoice, issue receipt, record payment and get invoice PDF in your own Számlázz.hu account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Számlázz.hu yourself; Cotlet does not store your password and you need no Számlázz.hu API key. About the official Számlázz.hu API: Yes. Számlázz.hu has an official API called Számla Agent, in operation since 2010, that issues, reverses and queries invoices and records payments over HTTP with XML (checked 14 Oct 2026). Setup and FAQ: https://cotlet.dev/integrations/szamlazz-hu-api-mcp-server
MCP server for ABRA Flexi — accounting, contacts, stock and draft-checked invoice creation.
Invoicing you drive by talking to your AI: log time, raise invoices and track what's owed via MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for the Billingo V3 Hungarian invoicing API. Manage invoices, partners, products, spendings, and bank accounts from any MCP client.14 npm1MIT
- AlicenseBqualityDmaintenanceMCP server for Invoice Ninja v5 API. Enables AI assistants to manage clients, invoices, quotes, payments, and time tracking through natural language.3222 npm2MIT
- FlicenseNot gradedqualityCmaintenanceAn MCP server that connects Claude to FreshBooks, enabling reading and management of invoices, clients, expenses, projects, and time entries via natural language.1-
- AlicenseNot gradedqualityAmaintenanceMCP server enabling AI assistants to manage invoices, contacts, products, and other accounting data through the Bukku API.9MIT