Billy
Read Danish accounting data — contacts, invoices, bills, accounts, and posted entries from Billy.
Overview
Connect Billy to give AI clients read access to Danish accounting data: organization details, contacts, sales invoices, purchase bills, products, chart of accounts, postings, and daybook transactions.
Prerequisites
- A Billy account with API access
- A stackgate.ai account
Getting credentials
- Sign in to stackgate.ai.
- Go to My Integrations and open Billy.
- In a separate tab, log in to mit.billy.dk.
- Go to Settings → Access tokens and click Create access token.
- Enter a descriptive name and save the token.
- Copy the token and paste it into stackgate.ai, then click Save.
Each access token is tied to one Billy company. To connect another company, create a separate token in that company's Billy account.
Using with AI clients
- Dedicated endpoint:
POST /mcp/billywith a Sanctum bearer token - Private gateway: one config for all integrations — use
billy__*namespaced tools
See Documentation for HTTP authentication and private gateway setup.
Troubleshooting
- 422 integration not configured — add your Billy access token in My Integrations.
- 401 / invalid token — verify the token in mit.billy.dk under Settings → Access tokens; create a new token if it was revoked.
- 403 during connect — company access tokens cannot list all organizations; stackgate.ai verifies via contacts/accounts instead. If connect still fails, ensure the token was created inside the target company in mit.billy.dk.
- Multiple companies — one hub connection maps to one Billy company token; use separate tokens per company.
- Locked organization — if Billy reports the company is locked (
isLocked), resolve the issue in mit.billy.dk before retrying.
Available tools
-
get-organization-tool
Get a Billy organization by ID. Defaults to the connected company when organization_id is omitted.
-
list-organizations-tool
List Billy organizations accessible to the connected access token.
-
list-contacts-tool
List contacts (customers and suppliers) in Billy.
-
get-contact-tool
Get a Billy contact by ID.
-
list-invoices-tool
List sales invoices in Billy.
-
get-invoice-tool
Get a Billy sales invoice by ID. Use include to embed line items.
-
list-products-tool
List products in the Billy product catalog.
-
get-product-tool
Get a Billy product by ID.
-
list-bills-tool
List purchase bills in Billy.
-
get-bill-tool
Get a Billy purchase bill by ID. Use include to embed line items.
-
list-accounts-tool
List accounts in the Billy chart of accounts.
-
get-account-tool
Get a Billy account by ID.
-
list-postings-tool
List posted ledger entries in Billy for a date range.
-
list-daybook-transactions-tool
List daybook transactions (vouchers) in Billy.
-
get-daybook-transaction-tool
Get a Billy daybook transaction by ID. Use include to embed lines.
MCP endpoint:
https://stackgate.ai/mcp/billy
(HTTP) or via the private gateway.