# Billy: how to read it into Maplith

*Accounting · also known as Billy Regnskab, Billy's Billing, Billy Regnskabsprogram · last checked 2026-10-08 · recipe `maplith://systems/billy`*

Billy holds a small company's contacts, sales invoices, bills, products, chart of accounts and posting journal, which tie sales and payments to the books.

## Best path

**Recommended: export files.** No official MCP server or client connector was found, and Billy's export menu gives the posting journal, contacts, products and chart of accounts as files for a chosen period. A Billy access token gives full read and write access, so a file export is the safer read-only path.

Try the paths in this order (ADR-0031):

1. **Your agent fetches it**, with the access your human already gave you. No named client connector confirmed: check the tools you already have. The customer's agent checks whether it already has a Billy tool it trusts, and if so reads only the chart of accounts, contacts and products. The posting journal and invoice history should come from the export.
2. **Maplith reads an MCP server your human already has.** No official MCP server confirmed. Community MCP servers for Billy exist on GitHub, but none is from Billy. Maplith reads only a server that serves MCP resources and takes a token a person types under Data sources › Systems in the Maplith app, such as the customer-run template for a database (ADR-0028).
3. **Export files**, the fallback that always works: see *Export steps* below.

## Datasets that make a good map

| Dataset | One row is | Key columns | Joins to |
|---|---|---|---|
| Contacts (Kontakter) | One customer or supplier. | contact number, CVR number of a business customer, EAN number, customer or supplier flag, contact email (Maplith tries to mask it) | CRM companies by CVR number; webshop customers by email; invoices and bills by contact. |
| Invoices (Fakturaer) | One sales invoice or credit note with its lines, totals, dates and payment status. | invoice number, contact number, product number on each line, invoice date, due date | Payment providers, webshop orders and bank lines by invoice number; Contacts by contact number; Products by product number. |
| Products (Produkter) | One product or service that can be put on an invoice. | product number, product name | Webshop and inventory products by product number (SKU); invoice lines by product number. |
| Posting journal (Posteringsjournal) | One booked line on one account, with date, transaction number and amount. | account number, transaction number, date | Chart of accounts by account number; bank statements and payouts by date and amount; invoices and bills by transaction. |
| Chart of accounts (Kontoplan) | One account in the ledger, with number and name. | account number, account name | Posting journal by account number. |

Columns are named, never their values. Maplith tries to mask personal data such as email addresses, but that is best effort: your human decides what goes in.

## Read-only access

**Who usually has the rights:** The owner of the Billy account; only the owner manages users. An invited accountant (Revisor role) can see the books but cannot manage users.

**For the key your own agent's client uses, choose only these read permissions:** `Access token (full access to one company; Billy offers no read-only scope)`, `Revisor role`, `Begrænset admin role`

**Where to click:**

1. Log in to Billy
2. Settings
3. Access tokens
4. Create access token
5. Give it a clear name and click Save
6. Hover over the token and click the magnifier to copy it

A key or token made here stays in the tool that reads the system for your human, never in a chat. Maplith asks for one only under Data sources › Systems in the app, and only for an MCP server it can read.

## Export steps

**Format:** CSV or XLS · **Date range:** The current and previous financial year

1. Click Rapporter, then Eksport.
2. Choose the list you need: Posteringsjournal, Kontospecifikation, Kontakter, Produkter or Kontoplan.
3. Choose the period and the file type (CSV or Excel) and click Eksporter.
4. For invoices and payments per customer, open Regnskab, Eksport and download Kunde- eller leverandørkontokortet.
5. The Backup shortcut under Rapporter, Eksport downloads every transaction as a PDF with its vouchers; it is an archive, not a data file.

## Volume hint

**About 10–300 invoices; 100–2,000 postings a month** (an estimate). Estimate for a small company, not a measured figure: Billy is aimed at micro and small companies, and each invoice or bill creates a few postings.

Every row an agent reads passes through its context, about one token per four characters. Above a few thousand rows a dataset, or for a daily refresh, prefer an MCP server or an export over fetching through the chat.

## Always

- Read-only, and never a credential sent to Maplith through the chat.
- The same recent period, a few months, from every system.
- Your human decides what goes in.

## Sources

Written from the vendor's public documentation, last checked 2026-10-08:

- https://www.billy.dk/api/
- https://www.billy.dk/support/article/backup-i-billy/
- https://www.billy.dk/support/article/roller-og-rettigheder/
- https://www.billy.dk/support/article/kunde-og-leverandorkontokort/
- https://www.billy.dk/support/article/importer-dine-kontakter-til-billy/
- https://www.billy.dk/support/article/inviter-en-kollega-revisor-eller-bogholder/