Skip to main content
Glama

Billomat MCP by usefulapi

Server Details

Read Billomat clients, invoices, offers, credit notes, reminders; create clients and draft invoices.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
Repository
m190/usefulapi-mcp
GitHub Stars
0

TDQS

Score is being calculated.

Available Tools

34 tools
billomat_add_invoice_item
Destructive
Inspect

WRITE: add one line item to an invoice that is still a DRAFT (Billomat refuses it for any other status). Does not complete or send the invoice.

ParametersJSON Schema
NameRequiredDescriptionDefault
typeNoPRODUCT or SERVICE.
unitNoUnit, e.g. Stunde, Stueck, hour.
titleNoItem title (required unless article_id is given).
optionalNoOffers only: mark the item as optional (its price is left out of the total).
quantityNoQuantity (required unless article_id is given).
tax_nameNoTax name; with tax_rate overrides the standard tax of the account.
tax_rateNoTax rate in percent; the account's standard rate when omitted.
reductionNoDiscount: absolute (10) or percent (10%).
article_idNoAn article id (from billomat_list_articles): title, unit, price and tax missing here are taken from the article.
invoice_idYesThe draft invoice id.
unit_priceNoUnit price, net or gross as net_gross of the document (required unless article_id is given).
descriptionNoItem description.
billomat_create_article
Destructive
Inspect

WRITE: create a new article (product or service) with a price. Billomat assigns the article number.

ParametersJSON Schema
NameRequiredDescriptionDefault
typeNoPRODUCT or SERVICE.
titleYesArticle title.
tax_idNoTax rate id (from billomat_list_taxes).
unit_idNoUnit id (from billomat_list_units).
descriptionNoDescription.
sales_priceNoSales price (net or gross as the account is set up).
currency_codeNoISO currency code, e.g. EUR (account default when omitted).
purchase_priceNoPurchase price.
billomat_create_client
Destructive
Inspect

WRITE: create a new client (customer) in Billomat. Billomat assigns the client number. Nothing is sent to the client. Check billomat_list_clients first to avoid duplicates.

ParametersJSON Schema
NameRequiredDescriptionDefault
wwwNoWebsite (without http).
zipNoZIP code.
cityNoCity.
nameNoCompany name.
noteNoInternal note.
emailNoEmail address.
phoneNoPhone.
stateNoState / region.
localeNoLocale of the documents, e.g. de-DE.
mobileNoMobile phone.
streetNoStreet and number.
last_nameNoLast name of the contact person.
first_nameNoFirst name of the contact person.
salutationNoSalutation, e.g. Herr, Frau.
tax_numberNoTax number.
vat_numberNoVAT ID.
country_codeNoISO 3166 alpha-2 country code, e.g. DE, AT, CH.
currency_codeNoISO currency code, e.g. EUR (account default when omitted).
billomat_create_draft_invoice
Destructive
Inspect

WRITE: create an invoice as a DRAFT (Entwurf) for a client, with optional line items. The invoice is NOT completed, has no number yet and is NOT sent; review and complete it in Billomat. Nothing is charged.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateNoDocument date (yyyy-mm-dd; today when omitted).
noteNoClosing note.
introNoIntroduction text.
itemsNoLine items (up to 200). More can be added to the draft later.
labelNoLabel / subject.
titleNoDocument title.
due_daysNoDays until payment is due.
client_idYesThe client id (from billomat_list_clients).
net_grossNoWhether prices are net or gross.
contact_idNoA contact of that client.
currency_codeNoISO currency code, e.g. EUR (account default when omitted).
billomat_create_draft_offer
Destructive
Inspect

WRITE: create an offer (Angebot) as a DRAFT for a client, with optional line items. The offer is NOT completed, has no number yet and is NOT sent; review and complete it in Billomat.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateNoDocument date (yyyy-mm-dd; today when omitted).
noteNoClosing note.
introNoIntroduction text.
itemsNoLine items (up to 200). More can be added to the draft later.
labelNoLabel / subject.
titleNoDocument title.
client_idYesThe client id (from billomat_list_clients).
net_grossNoWhether prices are net or gross.
contact_idNoA contact of that client.
currency_codeNoISO currency code, e.g. EUR (account default when omitted).
validity_daysNoDays the offer stays valid.
billomat_get_article
Read-only
Inspect

Get one article with its prices, unit, tax and supplier.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe article id (from billomat_list_articles).
billomat_get_client
Read-only
Inspect

Get one client with address, contact person, bank details, payment terms and revenue.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe client id (from billomat_list_clients).
billomat_get_company
Read-only
Inspect

Show the own company data of the Billomat account (name, address, bank details, tax numbers, currency).

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

billomat_get_confirmation
Read-only
Inspect

Get one order confirmation.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe confirmation id (from billomat_list_confirmations).
billomat_get_credit_note
Read-only
Inspect

Get one credit note.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe credit note id (from billomat_list_credit_notes).
billomat_get_current_user
Read-only
Inspect

Show the Billomat user the API key belongs to (name, email, role and rights). Use it to check which rights the key has.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

billomat_get_delivery_note
Read-only
Inspect

Get one delivery note.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe delivery note id (from billomat_list_delivery_notes).
billomat_get_incoming_invoice
Read-only
Inspect

Get one incoming invoice with amounts and open amount.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe incoming invoice id (from billomat_list_incoming_invoices).
billomat_get_invoice
Read-only
Inspect

Get one invoice (status, totals, dates, client, payment terms). Its line items come from billomat_list_invoice_items.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe invoice id (from billomat_list_invoices).
billomat_get_offer
Read-only
Inspect

Get one offer (status, totals, validity, client).

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe offer id (from billomat_list_offers).
billomat_get_reminder
Read-only
Inspect

Get one payment reminder.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe reminder id (from billomat_list_reminders).
billomat_get_supplier
Read-only
Inspect

Get one supplier with address and bank details.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe supplier id (from billomat_list_suppliers).
billomat_invoice_totals
Read-only
Inspect

Invoice totals grouped by client, status, day, week, month or year (for example group_by=client,year). Takes the same filters as billomat_list_invoices. Read-only.

ParametersJSON Schema
NameRequiredDescriptionDefault
toNoDocuments dated on or before this day (yyyy-mm-dd).
fromNoDocuments dated on or after this day (yyyy-mm-dd).
noteNoFree-text search in the note.
tagsNoComma-separated tags (Schlagworte).
introNoFree-text search in the introduction text.
labelNoFree-text search in the label.
statusNoStatus filter: DRAFT, OPEN, PAID, OVERDUE, CANCELED; several separated by commas.
group_byYesGrouping: client, status, day, week, month, year; several separated by commas (the order sets the aggregation).
client_idNoOnly documents of this client (from billomat_list_clients).
article_idNoOnly documents containing this article.
contact_idNoOnly documents of this client contact.
payment_typeNoPayment type(s), e.g. CASH, BANK_TRANSFER, PAYPAL; several separated by commas.
invoice_numberNoInvoice number (case-insensitive).
billomat_list_articles
Read-only
Inspect

List the articles (products and services) with prices, units and tax. Paged.

ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number, 1-based (default 1). Use next_page from the previous reply.
tagsNoComma-separated tags (Schlagworte).
titleNoTitle (case-insensitive).
unit_idNoOnly articles with this unit (from billomat_list_units).
order_byNoSort order: field name plus ASC or DESC, several separated by commas, e.g. "date DESC" (default ascending).
per_pageNoResults per page, 1-1000 (default 100).
descriptionNoSearch in the description.
supplier_idNoOnly articles of this supplier.
currency_codeNoISO currency code, e.g. EUR (account default when omitted).
article_numberNoArticle number.
billomat_list_clients
Read-only
Inspect

List the clients (customers) of the account, filtered by name, number, email, contact person, country, note or tags. Paged.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameNoCompany / name (case-insensitive).
noteNoSearch in the note.
pageNoPage number, 1-based (default 1). Use next_page from the previous reply.
tagsNoComma-separated tags (Schlagworte).
emailNoEmail address.
order_byNoSort order: field name plus ASC or DESC, several separated by commas, e.g. "date DESC" (default ascending).
per_pageNoResults per page, 1-1000 (default 100).
last_nameNoLast name of the contact person.
first_nameNoFirst name of the contact person.
invoice_idNoComma-separated invoice ids: the clients of these invoices.
country_codeNoISO 3166 alpha-2 country code, e.g. DE, AT, CH.
client_numberNoClient number.
billomat_list_confirmations
Read-only
Inspect

List order confirmations (Auftragsbestaetigungen), filtered by client, status (DRAFT, COMPLETED, CANCELED, CLEARED), number, date range or text. Paged.

ParametersJSON Schema
NameRequiredDescriptionDefault
toNoDocuments dated on or before this day (yyyy-mm-dd).
fromNoDocuments dated on or after this day (yyyy-mm-dd).
noteNoFree-text search in the note.
pageNoPage number, 1-based (default 1). Use next_page from the previous reply.
tagsNoComma-separated tags (Schlagworte).
introNoFree-text search in the introduction text.
labelNoFree-text search in the label.
statusNoStatus filter: DRAFT, COMPLETED, CANCELED, CLEARED; several separated by commas.
order_byNoSort order: field name plus ASC or DESC, several separated by commas, e.g. "date DESC" (default ascending).
per_pageNoResults per page, 1-1000 (default 100).
client_idNoOnly documents of this client (from billomat_list_clients).
article_idNoOnly documents containing this article.
contact_idNoOnly documents of this client contact.
confirmation_numberNoConfirmation number (partial, case-insensitive).
billomat_list_credit_notes
Read-only
Inspect

List credit notes (Gutschriften), filtered by client, status (DRAFT, OPEN, PAID), date range or text. Paged.

ParametersJSON Schema
NameRequiredDescriptionDefault
toNoDocuments dated on or before this day (yyyy-mm-dd).
fromNoDocuments dated on or after this day (yyyy-mm-dd).
noteNoFree-text search in the note.
pageNoPage number, 1-based (default 1). Use next_page from the previous reply.
tagsNoComma-separated tags (Schlagworte).
introNoFree-text search in the introduction text.
labelNoFree-text search in the label.
statusNoStatus filter: DRAFT, OPEN, PAID; several separated by commas.
order_byNoSort order: field name plus ASC or DESC, several separated by commas, e.g. "date DESC" (default ascending).
per_pageNoResults per page, 1-1000 (default 100).
client_idNoOnly documents of this client (from billomat_list_clients).
article_idNoOnly documents containing this article.
contact_idNoOnly documents of this client contact.
credit_note_numberNoCredit note number (case-insensitive).
billomat_list_delivery_notes
Read-only
Inspect

List delivery notes (Lieferscheine), filtered by client, status (DRAFT, CREATED), number, date range or text. Paged.

ParametersJSON Schema
NameRequiredDescriptionDefault
toNoDocuments dated on or before this day (yyyy-mm-dd).
fromNoDocuments dated on or after this day (yyyy-mm-dd).
noteNoFree-text search in the note.
pageNoPage number, 1-based (default 1). Use next_page from the previous reply.
tagsNoComma-separated tags (Schlagworte).
introNoFree-text search in the introduction text.
labelNoFree-text search in the label.
statusNoStatus filter: DRAFT, CREATED; several separated by commas.
order_byNoSort order: field name plus ASC or DESC, several separated by commas, e.g. "date DESC" (default ascending).
per_pageNoResults per page, 1-1000 (default 100).
client_idNoOnly documents of this client (from billomat_list_clients).
article_idNoOnly documents containing this article.
contact_idNoOnly documents of this client contact.
delivery_note_numberNoDelivery note number (case-insensitive).
billomat_list_incoming_invoices
Read-only
Inspect

List incoming invoices (Eingangsrechnungen, from suppliers), filtered by supplier, status (OPEN, PAID, OVERDUE), number, date range, note or tags. Paged.

ParametersJSON Schema
NameRequiredDescriptionDefault
toNoDated on or before this day (yyyy-mm-dd).
fromNoDated on or after this day (yyyy-mm-dd).
noteNoFree-text search in the note.
pageNoPage number, 1-based (default 1). Use next_page from the previous reply.
tagsNoComma-separated tags (Schlagworte).
statusNoStatus filter: OPEN, PAID, OVERDUE; several separated by commas.
order_byNoSort order: field name plus ASC or DESC, several separated by commas, e.g. "date DESC" (default ascending).
per_pageNoResults per page, 1-1000 (default 100).
supplier_idNoOnly incoming invoices of this supplier.
incoming_numberNoIncoming invoice number.
billomat_list_invoice_items
Read-only
Inspect

List the line items (positions) of one invoice.

ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number, 1-based (default 1). Use next_page from the previous reply.
per_pageNoResults per page, 1-1000 (default 100).
invoice_idYesThe invoice id.
billomat_list_invoice_payments
Read-only
Inspect

List the payments that were recorded on invoices (read-only), optionally for one invoice, a date range or payment types.

ParametersJSON Schema
NameRequiredDescriptionDefault
toNoPayments on or before this day (yyyy-mm-dd).
fromNoPayments on or after this day (yyyy-mm-dd).
pageNoPage number, 1-based (default 1). Use next_page from the previous reply.
typeNoPayment type(s), e.g. CASH, BANK_TRANSFER, PAYPAL; several separated by commas.
user_idNoOnly payments recorded by this user.
order_byNoSort order: field name plus ASC or DESC, several separated by commas, e.g. "date DESC" (default ascending).
per_pageNoResults per page, 1-1000 (default 100).
invoice_idNoOnly payments of this invoice.
billomat_list_invoices
Read-only
Inspect

List invoices (Rechnungen), filtered by client, status (DRAFT, OPEN, PAID, OVERDUE, CANCELED), number, date range, text or tags. Paged; each invoice carries totals and the open amount.

ParametersJSON Schema
NameRequiredDescriptionDefault
toNoDocuments dated on or before this day (yyyy-mm-dd).
fromNoDocuments dated on or after this day (yyyy-mm-dd).
noteNoFree-text search in the note.
pageNoPage number, 1-based (default 1). Use next_page from the previous reply.
tagsNoComma-separated tags (Schlagworte).
introNoFree-text search in the introduction text.
labelNoFree-text search in the label.
statusNoStatus filter: DRAFT, OPEN, PAID, OVERDUE, CANCELED; several separated by commas.
order_byNoSort order: field name plus ASC or DESC, several separated by commas, e.g. "date DESC" (default ascending).
per_pageNoResults per page, 1-1000 (default 100).
client_idNoOnly documents of this client (from billomat_list_clients).
article_idNoOnly documents containing this article.
contact_idNoOnly documents of this client contact.
payment_typeNoPayment type(s), e.g. CASH, BANK_TRANSFER, PAYPAL; several separated by commas.
invoice_numberNoInvoice number (case-insensitive).
billomat_list_offers
Read-only
Inspect

List offers (Angebote), filtered by client, status (DRAFT, OPEN, WON, LOST, CANCELED, CLEARED), number, date range or text. Paged.

ParametersJSON Schema
NameRequiredDescriptionDefault
toNoDocuments dated on or before this day (yyyy-mm-dd).
fromNoDocuments dated on or after this day (yyyy-mm-dd).
noteNoFree-text search in the note.
pageNoPage number, 1-based (default 1). Use next_page from the previous reply.
tagsNoComma-separated tags (Schlagworte).
introNoFree-text search in the introduction text.
labelNoFree-text search in the label.
statusNoStatus filter: DRAFT, OPEN, WON, LOST, CANCELED, CLEARED; several separated by commas.
order_byNoSort order: field name plus ASC or DESC, several separated by commas, e.g. "date DESC" (default ascending).
per_pageNoResults per page, 1-1000 (default 100).
client_idNoOnly documents of this client (from billomat_list_clients).
article_idNoOnly documents containing this article.
contact_idNoOnly documents of this client contact.
offer_numberNoOffer number (partial, case-insensitive).
billomat_list_recurring_invoices
Read-only
Inspect

List recurring invoices (Abo-Rechnungen): name, cycle (DAILY, WEEKLY, MONTHLY, YEARLY), client and next run. Paged.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameNoName of the recurring invoice.
noteNoFree-text search in the note.
pageNoPage number, 1-based (default 1). Use next_page from the previous reply.
tagsNoComma-separated tags (Schlagworte).
cycleNoInterval.
introNoFree-text search in the introduction text.
labelNoFree-text search in the label.
order_byNoSort order: field name plus ASC or DESC, several separated by commas, e.g. "date DESC" (default ascending).
per_pageNoResults per page, 1-1000 (default 100).
client_idNoOnly documents of this client (from billomat_list_clients).
contact_idNoOnly documents of this client contact.
payment_typeNoPayment type(s), e.g. CASH, BANK_TRANSFER, PAYPAL; several separated by commas.
billomat_list_reminders
Read-only
Inspect

List payment reminders (Mahnungen), filtered by client, status (DRAFT, OPEN, OVERDUE, PAID, CANCELED), invoice number, date range or text. Paged.

ParametersJSON Schema
NameRequiredDescriptionDefault
toNoDocuments dated on or before this day (yyyy-mm-dd).
fromNoDocuments dated on or after this day (yyyy-mm-dd).
noteNoFree-text search in the note.
pageNoPage number, 1-based (default 1). Use next_page from the previous reply.
tagsNoComma-separated tags (Schlagworte).
introNoFree-text search in the introduction text.
labelNoFree-text search in the label.
statusNoStatus filter: DRAFT, OPEN, PAID, OVERDUE, CANCELED; several separated by commas.
subjectNoFree-text search in the subject.
order_byNoSort order: field name plus ASC or DESC, several separated by commas, e.g. "date DESC" (default ascending).
per_pageNoResults per page, 1-1000 (default 100).
client_idNoOnly documents of this client (from billomat_list_clients).
article_idNoOnly documents containing this article.
contact_idNoOnly documents of this client contact.
invoice_numberNoNumber of the reminded invoice (case-insensitive).
billomat_list_suppliers
Read-only
Inspect

List the suppliers of the account, filtered by name, email, contact person, country, note or tags. Paged.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameNoCompany / name.
noteNoSearch in the note.
pageNoPage number, 1-based (default 1). Use next_page from the previous reply.
tagsNoComma-separated tags (Schlagworte).
emailNoEmail address.
order_byNoSort order: field name plus ASC or DESC, several separated by commas, e.g. "date DESC" (default ascending).
per_pageNoResults per page, 1-1000 (default 100).
last_nameNoLast name of the contact person.
first_nameNoFirst name of the contact person.
country_codeNoISO 3166 alpha-2 country code, e.g. DE, AT, CH.
client_numberNoYour customer number at the supplier.
billomat_list_taxes
Read-only
Inspect

List the tax rates (Steuersaetze) of the account, with the default one.

ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number, 1-based (default 1). Use next_page from the previous reply.
order_byNoSort order: field name plus ASC or DESC, several separated by commas, e.g. "date DESC" (default ascending).
per_pageNoResults per page, 1-1000 (default 100).
billomat_list_units
Read-only
Inspect

List the units (Einheiten) used for article and item quantities, optionally filtered by name.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameNoUnit name (substring, case-insensitive).
pageNoPage number, 1-based (default 1). Use next_page from the previous reply.
order_byNoSort order: field name plus ASC or DESC, several separated by commas, e.g. "date DESC" (default ascending).
per_pageNoResults per page, 1-1000 (default 100).
billomat_update_client
DestructiveIdempotent
Inspect

WRITE: change fields of an existing client (only the fields you pass are changed; everything else stays). Read the client first with billomat_get_client. Nothing is sent to the client.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesThe client id.
wwwNoWebsite (without http).
zipNoZIP code.
cityNoCity.
nameNoCompany name.
noteNoInternal note.
emailNoEmail address.
phoneNoPhone.
stateNoState / region.
localeNoLocale of the documents, e.g. de-DE.
mobileNoMobile phone.
streetNoStreet and number.
last_nameNoLast name of the contact person.
first_nameNoFirst name of the contact person.
salutationNoSalutation, e.g. Herr, Frau.
tax_numberNoTax number.
vat_numberNoVAT ID.
country_codeNoISO 3166 alpha-2 country code, e.g. DE, AT, CH.
currency_codeNoISO currency code, e.g. EUR (account default when omitted).

Tool Schema Changelog

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

  1. 34 tool updates
    • First observedbillomat_add_invoice_item
    • First observedbillomat_create_article
    • First observedbillomat_create_client
    • First observedbillomat_create_draft_invoice
    • First observedbillomat_create_draft_offer
    • First observedbillomat_get_article
    • First observedbillomat_get_client
    • First observedbillomat_get_company
    • First observedbillomat_get_confirmation
    • First observedbillomat_get_credit_note
    • First observedbillomat_get_current_user
    • First observedbillomat_get_delivery_note
    • First observedbillomat_get_incoming_invoice
    • First observedbillomat_get_invoice
    • First observedbillomat_get_offer
    • First observedbillomat_get_reminder
    • First observedbillomat_get_supplier
    • First observedbillomat_invoice_totals
    • First observedbillomat_list_articles
    • First observedbillomat_list_clients
    • First observedbillomat_list_confirmations
    • First observedbillomat_list_credit_notes
    • First observedbillomat_list_delivery_notes
    • First observedbillomat_list_incoming_invoices
    • First observedbillomat_list_invoice_items
    • First observedbillomat_list_invoice_payments
    • First observedbillomat_list_invoices
    • First observedbillomat_list_offers
    • First observedbillomat_list_recurring_invoices
    • First observedbillomat_list_reminders
    • First observedbillomat_list_suppliers
    • First observedbillomat_list_taxes
    • First observedbillomat_list_units
    • First observedbillomat_update_client

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables interaction with the sevDesk accounting API for managing contacts, invoices, credit notes, orders, vouchers, transactions, and parts.
    12 npm
    1
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to read and draft accounting documents such as invoices, vouchers, contacts, and articles via the Lexware Office API, including PDF rendering and receipt uploads. Supports OAuth and static token authentication for secure access.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Integrates with the sevdesk German accounting API, providing 76 tools for full CRUD operations across contacts, invoices, vouchers, orders, credit notes, bank accounts, transactions, parts, tags, addresses, and communication ways.
    58 npm
    6
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    Provides read-only access to inv.bg invoicing data, enabling users to list clients and invoices and retrieve full document details and line items through natural language in Claude.
    1
    -
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.