Holded

Holded

Holded — the Spanish SMB business suite: contacts, sales and purchase documents, products, warehouses, treasury accounts and CRM funnels. REST API v1, API-key auth.

7-day free trial · No credit card · EU-hosted

Ask Holded anything

Try a real prompt against Holded via AnythingMCP — Claude calls the tools, returns the answer. Press Enter on your own message to install on Cloud.

Install Holded on Cloud
Holded · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

Setup in 2 minutes

  1. 1Start a free trial on cloud.anythingmcp.com.
  2. 2Click Holded in the connector store. Paste credentials when prompted.
  3. 3Mint an MCP API key and point your AI client at the generated MCP URL.
Install Holded now

Guides for Holded

Step-by-step setup for the most popular AI clients.

Setting up Holded

From the connector definition itself: where to find the credentials, what they need to be allowed to do, and which API this adapter talks to.

Getting a key

  1. Sign in to Holded and open Configuración → Desarrolladores → API key (Settings → Developers).
  2. Generate a key and put it in HOLDED_API_KEY. The key belongs to the account, not to a user, and carries full access to every module you have subscribed to — treat it as a password.

The key travels in a key header. Not Authorization, not a query parameter. Holded's own documentation calls it simply key.

This adapter uses Holded's v1 API (/api/invoicing/v1, /api/crm/v1), which is still served. Holded's current developer site documents a newer v2 API with Authorization: Bearer and different paths; this adapter does not use it.

Paging: every v1 list endpoint is paginated; pass page (2, 3, …) for the next page.

Contact filters are exact matches: phone, mobile and customId. There is no filter by contact type; read the type from each returned contact.

One API, several modules, one path prefix each. Invoicing lives under /invoicing/v1, CRM under /crm/v1, projects under /projects/v1, team under /team/v1. The tools below carry the right prefix per resource; a 404 on a path that looks right usually means the module is not on your plan.

Documents are one endpoint with a type. /invoicing/v1/documents/{docType} covers invoices, sales receipts, credit notes, estimates, purchase orders and supplier invoices — the docType path segment picks one: invoice, salesreceipt, creditnote, salesorder, proform, waybill, estimate, purchase, purchaseorder, purchaserefund. Filter further with paid (0 not paid, 1 paid, 2 partially paid), billed (0/1) and sort (created-asc/created-desc).

Dates are Unix timestamps in seconds, not ISO strings, on the starttmp/endtmp filters. This catches everyone once.

Cloud reachability: api.holded.com is public with a valid certificate.

Your AI is two clicks away from Holded.

Install the connector, paste your credentials, ask your AI a question. 7-day free trial, no credit card.