Skip to content
MCP server

Billy MCP by usefulapi

Read Billy invoices, bills, contacts, products and postings; create contacts and draft…

Install
Runs
Remotely
Version
1.27.0
Listing updated
4 days ago

About Billy MCP by usefulapi

Billy MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read Billy invoices, bills, contacts, products and postings; create contacts and draft invoices.

Install

Run in a terminal

claude mcp add --transport http billy https://billy.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://billy.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "billy": {
      "url": "https://billy.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "billy": {
      "type": "http",
      "url": "https://billy.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "billy": {
      "serverUrl": "https://billy.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "billy": {
      "type": "http",
      "url": "https://billy.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (15)

Read directly from the server.

billy_get_organization
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.
billy_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.
billy_get_contact
One contact by id, with its contact persons (names and e-mail addresses). GET /contacts/{id}.
billy_list_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.
billy_get_invoice
One invoice by id with its lines (product, description, quantity, unit price, amount, tax) and its payment associations. GET /invoices/{id}.
billy_list_bills
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.
billy_get_bill
One supplier bill by id with its lines. GET /bills/{id}.
billy_list_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.
billy_get_product
One product by id with its unit prices per currency. GET /products/{id}.
billy_list_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.
billy_list_tax_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.
billy_list_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.
billy_list_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.
billy_create_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.
billy_create_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.

Billy MCP by usefulapi FAQ

How do I add Billy MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http billy https://billy.usefulapi.io/mcp