MCP server

Billy MCP by usefulapi

io.usefulapi/billy

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

15

Token cost

About 4,601 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.billy]
url = "https://billy.usefulapi.io/mcp"

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add billy https://billy.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"billy","server_url":"https://billy.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"billy","server_url":"https://billy.usefulapi.io/mcp"}

Tools

• billy_create_contact ~502 tokens
  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 ~547 tokens
  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 cre
• billy_get_bill ~95 tokens
  One supplier bill by id with its lines. GET /bills/{id}.
• billy_get_contact ~108 tokens
  One contact by id, with its contact persons (names and e-mail addresses). GET /contacts/{id}.
• billy_get_invoice ~122 tokens
  One invoice by id with its lines (product, description, quantity, unit price, amount, tax) and its payment associations. GET /invoices/{id}.
• billy_get_organization ~111 tokens
  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_get_product ~102 tokens
  One product by id with its unit prices per currency. GET /products/{id}.
• billy_list_accounts ~213 tokens
  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_bank_lines ~625 tokens
  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_bills ~530 tokens
  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_list_contacts ~263 tokens
  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_pag
• billy_list_invoices ~612 tokens
  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_list_postings ~380 tokens
  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_list_products ~232 tokens
  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_list_tax_rates ~159 tokens
  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.

Browse

• Website monitoring
• Email
• Payments
• Invoicing and accounting

Related MCP servers

• Papierkram MCP by usefulapi
  Read Papierkram invoices, vouchers, contacts, projects, time; create contacts, time, draft invoices.
• FreeAgent MCP by usefulapi
  Read FreeAgent contacts, invoices, bills, banking and reports; add contacts, draft invoices, time.
• bexio MCP by usefulapi
  Read bexio contacts, invoices, quotes, bills, projects and journal; log time, draft invoices.
• Amberflo MCP by usefulapi
  Query and manage Amberflo metering & billing: customers, meters, usage, plans, invoices, prepaid.
• Practice Better MCP by usefulapi
  Read Practice Better clients, sessions, availability, services, packages, invoices and forms.
• Lawcus MCP by usefulapi
  Read Lawcus contacts, matters, leads, time and billing reports; create contacts and tasks.
• Teachworks MCP by usefulapi
  Read Teachworks students, families, tutors, lessons, invoices and payments; book lessons.
• Vyfakturuj MCP by usefulapi
  Read and create Vyfakturuj invoices and contacts: search, number series, payment methods, tags.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/billy.svg)](https://aptlynx.net/servers/io.usefulapi/billy)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents