What you need before you start
- Holded: the company account on a paid plan or a trial. The Holded API is not included in the free plan, and the connection uses it.
- Access to the Holded «Desarrolladores» (Developers) section, usually held by the owner or an administrator of the company.
- Claude: any plan works, including the free account, which allows one custom connector. On Team and Enterprise, an organisation owner adds the connector first.
isaak.pro is an independent service by Verifactu Business, a Holded Solution Partner; it is not built by Holded. The first connected company is free, and the Holded licence is bought separately from Holded. New to Holded? Start with What is Holded?.
Step 1: create the Holded key
The key (API Token) is what lets the connector read the company data. Every company has its own: an accounting firm’s key gives no access to its clients.
- In Holded, go to Configuración → Desarrolladores → Credenciales (Settings → Developers → Credentials).
- Click «+ Agregar API Token» (Add API Token) and choose permissions «Por áreas» (by area).
- Tick the areas you want to use. With «Leer» (Read) Claude only looks things up; with «Full» it can also prepare drafts that you confirm.
- Copy the full key right away: it starts with pat_ and Holded does not show it in full again.
The key walkthrough with screenshots is in Create your Holded key (in Spanish), and which permission each feature needs is in Holded API key permissions. Tick at least «Cuenta → Información de la cuenta: Leer» (Account → Account information: Read), so the company can be identified without mixing it up with another.
Step 2: add the connector in Claude
- In Claude, open Customise → Connectors.
- Click «Add custom connector».
- Give it a name, such as «Holded», and paste the connector address: https://isaak.pro/mcp
- Click «Add», then «Connect».
Claude and ChatGPT use the same address and the same features. To use it in ChatGPT too, follow How to connect Holded to ChatGPT.
Step 3: authorise your company (or all of them)
When you click «Connect», isaak.pro opens. You sign in with your email, paste the Holded key and check that the name and tax ID (CIF) are your company’s. Then you authorise Claude.
If you run several companies, click «Conectar otra empresa» (connect another company) before authorising and paste each company’s key. Finish with «Autorizar con todas mis empresas» (authorise with all my companies); the authorisation screen is in Spanish. In the conversation, name the company or give its tax ID. Accounting firms will find the details in your whole Holded portfolio in one chat.
The key is stored encrypted at isaak.pro and is never sent to Claude: Claude gets its own access, which you can revoke from the isaak.pro dashboard or by deleting the key in Holded.
First questions to check it works
- «Which companies can you work with?»
- «Isaak, catch me up»: a summary with unpaid invoices, purchases to pay, unreconciled bank movements and upcoming tax deadlines.
- «Which invoices are overdue and who owes me the most?»
- «Which bank movements this month are unreconciled, and which invoices do they match?»
- «Prepare a draft invoice for Retail Plus for 3 hours of consulting at €60 an hour.»
More ideas in 12 questions you can ask your Holded with AI.
What it does and what it does not
- Looks up sales, purchases, banks, contacts, accounting and the taxes set up in Holded.
- Prepares draft invoices, contacts, journal entries and reconciliations; you confirm every change.
- Never deletes data and never makes payments or transfers.
- Does not file taxes. Estimates, such as the quarterly VAT (IVA), are indicative: you review and file.
Isaak helps you look up and prepare information, but it does not replace a professional review. For taxes and specific cases, check with your accountant.
If something does not work
- «Missing permission»: edit the key in Holded and set that area to «Leer» or «Full». No need for a new key. Note that «Escribir» (Write) does not include «Leer» (Read).
- «Old key»: the connector only accepts the new keys, starting with pat_. Create one under Credenciales, not under «Api Keys v1».
- Only «Webhooks» shows under Desarrolladores: this usually happens with companies managed by an accounting firm without their own Holded licence; without one, the key cannot be created.
All other messages and what to do about them are in error messages and how to fix them (in Spanish).