Billy
Connect Claude, ChatGPT or Cursor to Billy via MCP. Secure read access to contacts, invoices, bills and posted entries — 15 tools, no code.
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
Get a Billy organization by ID. Defaults to the connected company when organization_id is omitted.
-
list_organizations
List Billy organizations accessible to the connected access token.
-
list_contacts
List contacts (customers and suppliers) in Billy.
-
get_contact
Get a Billy contact by ID.
-
list_invoices
List sales invoices in Billy.
-
get_invoice
Get a Billy sales invoice by ID. Use include to embed line items.
-
list_products
List products in the Billy product catalog.
-
get_product
Get a Billy product by ID.
-
list_bills
List purchase bills in Billy.
-
get_bill
Get a Billy purchase bill by ID. Use include to embed line items.
-
list_accounts
List accounts in the Billy chart of accounts.
-
get_account
Get a Billy account by ID.
-
list_postings
List posted ledger entries in Billy for a date range.
-
list_daybook_transactions
List daybook transactions (vouchers) in Billy.
-
get_daybook_transaction
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.
Related workflows
Multi-integration playbooks that use Billy to solve concrete business outcomes.