MCP server
Billy MCP by usefulapi
Read Billy invoices, bills, contacts, products and postings; create contacts and draft…
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://billy.usefulapi.io/mcpInstall 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