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

---

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

• 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 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:

License

MIT

---

<a name="magyar"></a>

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

• 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 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:

Licensz

MIT