Docs

Bilio MCP connector

Connect Bilio to any assistant that supports remote MCP servers. The connector is on Pro and Business, and in the 14-day free trial. 52 tools read your clients, invoices, quotes, expenses, hours and VAT return; draft invoices, quotes and credit notes; log and invoice hours; turn receipts into expenses; change status; delete; send; and manage currencies, within the permissions you give each assistant.

Connector URL

https://mcp.getbilio.com/mcp

Transport: Streamable HTTP. Authentication: OAuth 2.1 with your Bilio account. You do not need an API key.

Set it up

Claude
Settings → Connectors → Add custom connector. Paste the URL, then click Connect and sign in to Bilio.
ChatGPT
Settings → Apps & Connectors → Create (developer mode). Paste the URL as the MCP server, choose OAuth, then sign in to Bilio.
Cursor
Settings → MCP → Add new MCP server, or add this to your mcp.json. Cursor opens Bilio to sign in.
{
  "mcpServers": {
    "bilio": {
      "url": "https://mcp.getbilio.com/mcp"
    }
  }
}

Menu names change often in assistant apps. If yours look different, look for “custom connector” or “MCP server” and paste the URL above.

When you sign in, Bilio shows a consent screen. Pick the company the assistant may use and switch on what it may do. One connection works in one company. Change permissions or disconnect any time in Settings → Connected assistants, where you also see when each assistant was last used and its recent activity: every change it made, with the time.

Scopes and plans

ScopeAllowsAvailability
bilio.readRead clients, invoices, quotes, expenses and reports.Pro and Business
bilio.writeCreate, change, delete and send, within the permissions you give each assistant.Pro and Business (and their 14-day trial)

Permissions per assistant

PermissionAllowsDefault
ReadClients, invoices, quotes, expenses and reports. Always on.Always on
Create and edit draftsDraft invoices, quotes and credit notes, turn approved quotes into invoices, log hours and invoice them, set up recurring invoices, add clients, expenses and receipts. Drafts never reach a client.On
Change statusMark invoices paid, due or unpaid; mark quotes approved or rejected; revert to draft; pause, resume or cancel recurring invoices. No email is sent.Off
DeleteRemove draft invoices and quotes, recurring invoices, clients with no invoices, and expenses. Always shows a preview and asks you to confirm.Off
Change company settingsAdd, change or remove currencies and their rates. Off until you switch it on.Off
Send emails to clientsInvoices, quotes and payment reminders, with the PDF attached. Always shows you a preview and asks you to confirm before it goes out.Off

Writing also needs an owner or admin role: viewers can only ever read. Permission changes apply to the next request, with no need to reconnect.

Tools

52 tools: 14 to read, the rest to draft, change status, delete, send and change settings. All work in the company you chose when you connected. Amounts come with their currency, and dates are ISO dates (YYYY-MM-DD).

Read

ToolWhat it does
whoamiConnected companyWhich company this connection works in, your role and plan, and what this connection may do.
list_clientsList clientsClients, optionally filtered by name or email.
get_clientGet a clientOne client with contact details, VAT number and their latest invoices.
list_invoicesList invoicesInvoices, newest first. Filter by status (draft, sent, paid, overdue), client or invoice date.
get_invoiceGet an invoiceOne invoice with its lines, VAT and payment details.
list_quotesList quotesQuotes, newest first. Status: draft, sent, approved, rejected or expired.
list_expensesList expensesExpenses, newest first. Filter by date, category or vendor.
get_overdueOverdue invoicesSent invoices past their due date, most overdue first, with how many days late.
get_vat_summaryVAT summaryVAT for a quarter as on the VAT return: VAT charged, VAT on deductible expenses, and the balance to pay or reclaim.
get_pnlProfit and lossRevenue, deductible expenses and the result, excluding VAT, for a year or a date range.
list_timeList logged hoursHours logged in Bilio, newest first, with totals. Filter by dates, client, or only billable hours not invoiced yet.
list_currenciesList currenciesThe currencies invoices can be in, the default the books are kept in, and each one’s rate.
get_cashflowCash flowMoney in and money out, plus what is outstanding and overdue today. Defaults to the current month.
list_recurring_invoicesList recurring invoicesRecurring invoices with client, amount, how often, status and the next invoice date.

Create and edit drafts

ToolWhat it does
create_clientCreate a clientAdds a client. Refuses if a client with the same email exists.
update_clientEdit a clientChanges a client’s details. Existing invoices keep the details they were made with.
create_invoice_draftDraft an invoiceA draft invoice with your next number, default VAT rate, currency, bank account and the client’s usual payment term. Nothing is sent.
update_invoice_draftEdit a draft invoiceReplaces a draft’s lines, dates, currency or notes. Only drafts can be edited.
duplicate_invoiceDuplicate an invoiceA draft copy of an invoice with a new number and today’s date, like Duplicate in the app.
create_quote_draftDraft a quoteA draft quote with a valid-until date (30 days by default). Nothing is sent.
update_quote_draftEdit a draft quoteReplaces a draft quote’s lines, currency, valid-until date or notes.
create_expenseLog an expenseAdds an expense, amount including VAT, in one of Bilio’s categories.
update_expenseEdit an expenseChanges an expense’s date, vendor, amount, VAT, category or whether it is deductible.
categorise_expenseChange an expense categorySets the category of an expense.
create_credit_noteCorrect an invoice with a credit noteA draft credit note for a sent or paid invoice: every amount negated, its own number and a reference to the original, which is never changed.
log_timeLog hoursLogs time worked, like Hours in Bilio: “3 hours for Brightfold on the website today”. Billable by default when there is a client, at the client’s or your default rate.
invoice_timeInvoice unbilled hoursA draft invoice from a client’s billable hours not invoiced yet, one line per project or per day and task. Nothing is sent.
add_expense_from_receiptAdd an expense from a receiptBilio reads a receipt (PDF or image, up to 5MB) into an expense with the receipt attached, marked To review.
attach_receiptAttach a receiptAttaches a receipt file to an existing expense.
convert_quote_to_invoiceTurn an approved quote into an invoiceA draft invoice from an approved quote (same client, lines, VAT and currency), like Convert to Invoice. Each quote converts once.
create_recurring_invoiceSet up a recurring invoiceBilio creates a draft invoice with these lines every week, month, quarter or year. Nothing is sent automatically.
update_recurring_invoiceEdit a recurring invoiceChanges its name, client, lines, schedule or notes.
generate_recurring_invoice_nowCreate the next recurring invoice nowMakes the next draft straight away, like Generate now; the schedule moves on.

Change status

ToolWhat it does
mark_invoice_paidMark an invoice as paidRecords payment of a due or overdue invoice, like “Mark as Paid”. No email is sent.
mark_invoice_sentMove an invoice to DueFor invoices you sent yourself outside Bilio, like “Move to Due”. Does not email the client.
mark_invoice_unpaidUndo “paid”Moves a paid invoice back to Due and removes the payment record, to correct a mistake.
revert_invoice_to_draftRevert an invoice to draftMoves a due invoice back to draft so it can be edited. Anything already emailed stays with the client.
mark_quote_approvedMark a quote as approvedRecords that the client accepted, like “Mark as Approved”. No email is sent.
mark_quote_rejectedMark a quote as rejectedRecords that the client turned it down. No email is sent.
revert_quote_to_draftRevert a quote to draftMoves a sent quote back to draft so it can be edited.
pause_recurring_invoicePause a recurring invoiceStops new drafts until you resume it.
resume_recurring_invoiceResume a recurring invoiceStarts a paused recurring invoice again.
cancel_recurring_invoiceCancel a recurring invoiceStops it for good; invoices it already made are kept.

Delete

ToolWhat it does
delete_invoice_draftDelete a draft invoiceDraft invoices only: due and paid invoices are part of your books and can’t be deleted.
delete_quote_draftDelete a draft quoteDraft quotes only.
delete_clientDelete a clientOnly clients with no invoices or quotes.
delete_expenseDelete an expenseAny expense.
delete_recurring_invoiceDelete a recurring invoiceRemoves it for good; invoices it already made are kept.

Change company settings

ToolWhat it does
manage_currencyAdd, change or remove a currencyLike Settings â€ș Bank & currencies: add a currency, change its rate, name or symbol, make it the default, or remove it.

Send emails to clients

ToolWhat it does
send_invoiceSend an invoice by emailEmails an invoice with its PDF attached, exactly like Send in Bilio; a draft becomes Due.
send_quoteSend a quote by emailEmails a quote with its PDF attached, like Send in Bilio.
send_reminderSend a payment reminderEmails a reminder for a due or overdue invoice, with the invoice PDF attached.

Receipts

add_expense_from_receipt reads a receipt into a new expense with the file attached: supplier, date, amount, VAT and the supplier’s country. attach_receipt adds a file to an expense you already have, and create_expense takes one too. Send the file as base64, or as an https link Bilio can download without signing in.

  • PDF, JPG, PNG, WEBP or HEIC, up to 5MB. Files are checked by their contents, not their name.
  • Links to private or local addresses are refused.
  • Expenses read from a receipt are marked To review and stay out of the VAT return until someone checks them in Bilio.

Safety rules

  • Everything an assistant creates is a draft. Drafts never reach a client.
  • Sent and paid invoices can’t be edited or deleted: they are part of your books. Revert to draft or undo “paid” first, with the status permission.
  • Deletes take two steps. The first call returns a preview and a one-time code; only a second call with that code deletes. The code works once, for that record and that connection, and expires after 10 minutes.
  • Changing status never emails your client.
  • Sent and paid invoices are corrected with a credit note (create_credit_note), a new draft that references the original; the original is never changed.
  • Changing company settings (currencies) needs its own permission, off by default.
  • Every change an assistant makes is logged with the tool, a short summary and the time, and shown under Recent activity in Settings → Connected assistants.
  • Emails to clients (invoices, quotes and reminders) take two steps as well: a preview first, and nothing is sent until you confirm. Sending needs the send permission, which is off by default.

For developers: OAuth details

Where your data goes

The connector runs in the EU (europe-west1 (Belgium)), next to the Bilio database. What a tool returns goes to the assistant you connected, and that provider’s own terms apply to it. The privacy policy has the details.

Help

Something not working, or a tool you need? Email [email protected]. For what the connector is for and what to ask, see Natively AI.