# Billy MCP by usefulapi

> Billy MCP by usefulapi is an MCP server. Read Billy invoices, bills, contacts, products and postings; create contacts and draft invoices. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/billy/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/billy
- **MCP Registry name:** io.usefulapi/billy
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://billy.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "billy": {
      "url": "https://billy.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/billy-mcp-by-usefulapi
