io.usefulapiPublished by usefulapi.ioOfficial publisherv1.23.5Updated Nov 8, 2026
Read Billy invoices, bills, contacts, products and postings; create contacts and draft invoices.
The publisher's own server: Ably MCP by usefulapi
Billy MCP by usefulapi's hosted MCP server (billy.usefulapi.io), published by usefulapi.io; no sign-in required; Streamable HTTP; 15 tools.
No AI overview yet: these facts come from the registry entry and the server itself.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.usefulapi%2Fbilly/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"billy-by-usefulapi": {
"type": "http",
"url": "https://billy.usefulapi.io/mcp"
}
}
}Use Billy from Claude, Cursor, or any MCP client — invoices, bills, contacts, products, accounts, bank lines and postings, plus contacts and draft invoices. Hosted, no local install: connect with your own Billy credentials.
Live endpoint: https://billy.usefulapi.io/mcp · Homepage: https://usefulapi.io/billy
https://billy.usefulapi.io/mcp.claude mcp add --transport http billy https://billy.usefulapi.io/mcp, then run /mcp to log in.Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Billy credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/billy/
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].
Pro covers this server only. Subscribe with billy_upgrade (it returns a Stripe Checkout link). Cancel any time with billy_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running billy_upgrade before then undoes the cancel. Or write to [email protected].
MIT © usefulapi. Not affiliated with or endorsed by Billy.
Source: servers/billy/README.md at commit 4046075
Get the company
The Billy company the access token belongs to: id, name, address, registration (CVR) number, base currency, VAT settings, fiscal year, default payment terms, invoice numbering, default accounts. Good first call. GET /organization.
Takes no parameters.
List contacts
List customers and suppliers: name, type, address, CVR/registration number, EAN, payment terms, customer/supplier flags. The API has no documented search filter, so `search` is applied to the returned page only (case-insensitive on name, contact number and registration number); page on with next_page to look further. Paged. GET /contacts.
pagesearchpage_sizeGet a contact
One contact by id, with its contact persons (names and e-mail addresses). GET /contacts/{id}.
idrequiredList invoices
List sales invoices and credit notes (newest first by default): number, date, due date, state (draft/approved/voided), amount, tax, balance, isPaid, contactId, currency. Filter by state, customer, number, date, period, paid status or free text. Paged. GET /invoices.
qpagestateis_paidpage_sizecontact_idinvoice_nomax_due_datemin_due_datesort_propertymax_entry_datemin_entry_date+2 moreGet an invoice
One invoice by id with its lines (product, description, quantity, unit price, amount, tax) and its payment associations. GET /invoices/{id}.
idrequiredList bills (supplier invoices)
List bills (purchase invoices from suppliers): supplier, dates, state (draft/approved/voided), amount, balance, isPaid, supplier invoice number. Filter by state, supplier, dates or paid status. Paged. GET /bills.
qpagestateis_paidpage_sizecontact_idmax_due_datemin_due_datesort_propertymax_entry_datemin_entry_datesort_direction+1 moreGet a bill
One supplier bill by id with its lines. GET /bills/{id}.
idrequiredList products
List products and services usable as invoice lines: name, product number, description, sales account, archived flag. The API has no documented search filter, so `search` is applied to the returned page only (name, productNo). Paged. GET /products.
pagesearchpage_sizeGet a product
One product by id with its unit prices per currency. GET /products/{id}.
idrequiredList accounts (chart of accounts)
The chart of accounts: account number, name, group, nature, VAT rate, bank-account flag and bank details (IBAN, bank name) of bank accounts. With is_bank_account=true this lists the bank accounts whose ids billy_list_bank_lines needs. Paged. GET /accounts.
pagepage_sizeis_bank_accountList tax (VAT) rates
The company's VAT rates: name, rate (as a fraction, 0.25 = 25 percent), whether it applies to sales or purchases, active flag. Paged. GET /taxRates.
pagepage_sizeList bank lines
List the bank-statement lines of ONE bank account (read only; nothing is matched or reconciled): date, description, amount, side (debit/credit), reconciled flag, receipt state. Get the account id from billy_list_accounts with is_bank_account=true. Paged. GET /bankLines.
qpagesidestatuspage_sizeaccount_idrequiredmax_amountmin_amountis_reconciledreceipt_statesort_propertymax_entry_date+3 moreList ledger postings
List ledger postings (the bookkeeping entries): date, text, account, amount, side (debit/credit), currency, voided flag. Filter by account, date or period. Read only. Paged. GET /postings.
qpageis_voidedpage_sizeaccount_idmax_entry_datemin_entry_dateentry_date_periodCreate a contact
WRITE: create ONE new contact (customer and/or supplier) in the company's Billy account. It does not check for duplicates (call billy_list_contacts first) and nothing is sent to the contact. Not idempotent: a repeat call creates a second contact. POST /contacts.
eancitynamerequiredtypeemailphonestreetzipcodecontact_nocountry_idis_customeris_supplier+1 moreCreate a draft invoice
WRITE: create ONE invoice in the DRAFT state for an existing contact. The invoice is NOT approved, booked, numbered into the ledger or sent: the user reviews it in Billy and approves and sends it there. The invoice number is assigned by Billy. No payment is created. Not idempotent: a repeat call creates a second draft. POST /invoices with state=draft.
linesrequiredtax_modecontact_idrequiredentry_datecurrency_idcontact_message100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
io.usefulapiOfficial publisher
Ably MCP by usefulapi's hosted MCP server, published by usefulapi.io; no sign-in required; Streamable HTTP; 15 tools.
io.usefulapiOfficial publisher
Hosted read-only MCP server that lets an assistant read Tiltify campaigns, donations and top donor and fundraiser leaderboards.
io.usefulapiOfficial publisher
Hosted Termii server that lets an assistant send SMS, check wallet balance, DND status, sender IDs and message history.
io.usefulapiOfficial publisher
Hosted MCP server that lets an assistant read Temp Stick temperature and humidity sensors, their readings and alert notifications.
io.usefulapiOfficial publisher
Connects an assistant to a Stibee email marketing workspace to read address books, subscribers and email stats, and to add subscribers and group members.
{ "mcpServers": { "billy": { "url": "https://billy.usefulapi.io/mcp" } }}