io.github.nubiia-devPublished by GitHub account nubiia-devv2.0.3Updated Oct 29, 2026
Complete Holded Invoice API integration with 72 MCP tools for invoices, contacts, products, and more
MCP server for the Holded ERP API v2, letting an assistant manage invoices, contacts, products, treasury, ledger and HR data in a Holded account.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
[CI] [npm version] [License: MIT] [codecov] [by Nubiia]
A Model Context Protocol (MCP) server for the Holded API. This server lets AI assistants like Claude interact with Holded's invoicing, accounting, contacts, products, treasury, HR, time tracking and more.
Built and maintained by Nubiia — automatización e integraciones con IA para negocios (MCP, Holded, Pipedrive y más). ¿Quieres algo así para tu empresa? Escríbenos en nubiia.es.
This MCP server provides access to the Holded API v2 across all supported modules:
Total: 119 tools — all registered unconditionally once a valid v2 key is configured.
pat_… or sk_live_…) — generate it in Holded → Settings → APIAll tools call the Holded API v2 (Bearer auth, cursor pagination). You need a single v2 key:
Generate the key in Holded → Settings → API. The key must start with pat_ or sk_live_. A 403 response means the key is missing a required scope.
For multi-tenant setups use the same logic per tenant:
TENANT_N_API_KEY_V2 is accepted as an alias for TENANT_N_API_KEY (wins if both are set).
Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Or if installed from source:
The server now calls the Holded API v2 exclusively. Your 1.x API key (a plain hex string like abc123…) no longer works. Generate a v2 key in Holded → Settings → API; the key will start with pat_ or sk_live_.
Set it as HOLDED_API_KEY (or the alias HOLDED_API_KEY_V2). The separate HOLDED_API_KEY_V2 variable used in 1.x to opt-in to HR/Ledger/Treasury tools is no longer needed — all 119 tools are always registered.
List tools changed from page-based to cursor-based pagination:
Responses now follow this envelope:
Iterate by passing nextCursor as cursor until hasMore is false.
snake_case throughout (e.g. contact_id, created_at)."1.234,56") — parse with your locale-aware number parser before doing arithmetic.Attachments are now fetched by filename instead of attachment ID. Use get_contact_attachment with the filename field returned by list_contact_attachments.
Once configured, you can ask Claude to:
The API supports these document types:
The server routes each tool to the appropriate v2 sub-path (e.g. /invoicing/v2/, /team/v2/, /accounting/v2/).
All requests use Bearer authentication with your v2 key:
List endpoints use cursor-based pagination via limit and cursor arguments (see Migrating from 1.x).
Create/update/delete tools modify real data in Holded. The server applies per-tool rate limits (stricter for destructive operations) to prevent accidental bulk mutations. Destructive operations are capped at 10 requests/minute by default; update operations at 30 requests/minute.
Data Collection: This MCP server requires your Holded API key to function. The API key is read from your local environment variable (HOLDED_API_KEY) and is never stored by this server. All API requests and responses are passed through in real-time to facilitate communication between your AI assistant and the Holded API.
Data Usage & Sharing: Your API key and all data processed through this server are used exclusively to interact with the Holded API on your behalf. The server acts as a pass-through proxy - it does not store, log, or retain any data. Your Holded API key and data are transmitted only to Holded's official API endpoints (api.holded.com). No data is shared with any third parties beyond Holded.
Your Security: We recommend following security best practices: store your API key in environment variables (never commit it to version control), regularly update to the latest version, and review the permissions granted to this MCP server in your AI assistant. For more information, see our full Privacy Policy.
For questions, issues, or feature requests:
This MCP server is built and maintained by Nubiia.
Nubiia ayuda a empresas a automatizar procesos e integrar sus herramientas con IA: servidores MCP a medida, integraciones con Holded, Pipedrive y otros ERPs/CRMs, y agentes que conectan tus datos de negocio con asistentes como Claude. Este @nubiia/mcp-holded es un ejemplo open source de lo que hacemos.
👉 ¿Quieres una integración o automatización con IA para tu negocio? nubiia.es · ✉️ [email protected]
MIT - See LICENSE file for details.
Built by Nubiia — nubiia.es · [email protected]
Maintainer: Samuel Fraga — GitHub · LinkedIn
Source: README.md at commit e6cbae6
List documents of a specific type (Holded API v2). Cursor-paginated: pass the previous response nextCursor as cursor. Response fields are snake_case; amounts are strings with decimal comma. NOTE: purchaserefund is not listable in v2 — only creation is supported (POST /purchases/refund).
limitcursorfieldsdocTyperequiredsummaryCreate a new document (invoice, estimate, purchase, etc.). By default the document is approved (finalized) so it appears in the Holded UI; pass approveDoc:false to create a draft instead. Set the expense/income account at document level via `expAccountId` (it cascades to all lines); a per-line `account` is rejected because Holded ignores it. On SALES documents an auto-incrementing numbering series may OVERRIDE the requested `invoiceNum` — the tool re-reads the created document and returns a `_warnings` note if that happened. On purchases the supplier number in `invoiceNum` is preserved. `retention` (IRPF) is accepted on sales but rejected on purchases (Holded ignores it there).
daterequireditemsrequirednotesdocTyperequiredcurrencycontactIdrequiredretentionapproveDocinvoiceNumexpAccountIdsalesChannelIdGet a specific document by ID
docTyperequireddocumentIdrequiredGet the payments registered against a specific document via the Holded API v2 GET endpoint. Returns `{ documentId, paymentsDetail }` when the v2 response includes a `paymentsDetail` field; otherwise returns the whole document (v2 field name may differ from v1). Unlike list_payments — which is filtered to the ACTIVE fiscal year — this surfaces payments from ANY year, so use it for cross-year payment audits. Read-only.
docTyperequireddocumentIdrequiredUpdate an existing document
dateitemsnotesdocTyperequiredcurrencycontactIdretentiondocumentIdrequiredinvoiceNumexpAccountIdsalesChannelIdDelete a document
docTyperequireddocumentIdrequiredRegister a payment for a document (Holded API v2). Supported docTypes: invoice, salesreceipt, creditnote, receiptnote, purchase — others throw an unsupported error. IMPORTANT: this may AUTO-APPROVE the document as a side effect (status 0→1). `paymentmethod` is the payment-method catalog id (from list_payment_methods), NOT a bank/treasury id. To link the payment to a bank account, pass `bankId`: the /payments endpoint can't set it, so the tool performs a second step (PUT /payments/{id}) and reports the outcome in `_warnings`.
dateamountrequiredbankIddocTyperequireddocumentIdrequiredtreasuryIdpaymentmethodSend a document by email (Holded API v2). Supported docTypes: invoice, salesreceipt, creditnote, receiptnote, estimate, proform, salesorder, waybill, purchaseorder. purchase and purchaserefund are not supported in v2.
emailsdocTyperequiredmessagesubjectdocumentIdrequiredGet the PDF of a document as base64-encoded binary (Holded API v2). Returns { contentType, base64, bytes, filename }. Supported docTypes: invoice, salesreceipt, creditnote, receiptnote, estimate, proform, salesorder, waybill, purchaseorder. purchase is NOT supported — GET /purchases/{id}/pdf returns 404 for all purchases. purchaserefund has no CRUD support in v2.
docTyperequireddocumentIdrequiredShip all items of a document (Holded API v2). salesorder → POST /sales-orders/{id}/ship. purchaseorder → POST /purchase-orders/{id}/receive (receive from supplier). All other docTypes are not supported in v2.
docTyperequireddocumentIdrequiredShip specific items by line (Holded API v2). salesorder only → POST /sales-orders/{id}/ship-by-lines. purchaseorder line-level receive is UNVERIFIED in v2 and throws unsupported. All other docTypes are not supported.
linesrequireddocTyperequireddocumentIdrequiredGet shipped/received units for a document (Holded API v2). salesorder → GET /sales-orders/{id}/shipped-items. purchaseorder → GET /purchase-orders/{id}/received-items. All other docTypes are not supported.
docTyperequireddocumentIdrequiredAttach a file to a document (Holded API v2). POST ${docBase}/{id}/attachments multipart. Supported for all docTypes except purchaserefund (v2 has no purchase-refund CRUD beyond creation).
docTyperequiredfilenamerequireddocumentIdrequiredfileBase64requiredUpdate tracking information for a document (Holded API v2). Supported docTypes: salesorder (PUT /sales-orders/{id}/tracking) and waybill (PUT /waybills/{id}/tracking). All other types have NO EQUIVALENT in v2 and will throw an unsupported error. NOTE: this is a discrepancy with the task brief (which stated "all types unsupported") — the normative annex tables show salesorder and waybill do have tracking in v2.
carrierdocTyperequireddocumentIdrequiredtrackingNumberUpdate pipeline stage for a document (Holded API v2). Uses PUT — verb changed from POST in v1. Supported for all docTypes except purchaserefund (v2 limitation). Route: PUT ${docBase}/{id}/pipeline.
docTyperequiredstageIdrequireddocumentIdrequiredpipelineIdrequiredList available payment methods (Holded API v2). GET /payment-methods. Returns an array of {id, name, type, status, isDefault, bankingAccountId} — the v2 {items:[...]} envelope is normalized to a bare array.
Takes no parameters.
List contacts (Holded API v2). Cursor-paginated: pass the previous response nextCursor as cursor. Response fields are snake_case; amounts are strings with decimal comma.
limitcursorfieldssummaryCreate a new contact (Holded API v2)
codenamerequirednotetypeemailphonetradenamebillAddresscontactPersonsGet a specific contact by ID (Holded API v2)
contactIdrequiredUpdate an existing contact (Holded API v2)
codenamenotetypeemailphonecontactIdrequiredtradenamebillAddresscontactPersonsDelete a contact (Holded API v2)
contactIdrequiredGet list of attachments for a contact (Holded API v2). Use the filenames from the response with get_contact_attachment.
contactIdrequiredGet a specific attachment from a contact by filename (Holded API v2). BREAKING CHANGE from v1: the path parameter changed from attachmentId (numeric/UUID) to filename (string). Obtain filenames from list_contact_attachments first.
filenamerequiredcontactIdrequiredList products (Holded API v2). Cursor-paginated: pass the previous response nextCursor as cursor. Server-paginated; use limit to control page size. Response fields are snake_case; amounts are strings with decimal comma.
limitcursorfieldssummaryCreate a new product (Holded API v2)
skutaxkindnamerequiredpricestockbarcodecostPricedescriptionGet a specific product by ID (Holded API v2)
productIdrequiredUpdate an existing product (Holded API v2)
skutaxnamepricebarcodecostPriceproductIdrequireddescriptionDelete a product (Holded API v2)
productIdrequiredGet the main image of a product (Holded API v2)
productIdrequiredList all images of a product (Holded API v2)
productIdrequiredGet a secondary image of a product (Holded API v2)
imageIdrequiredproductIdrequiredUpdate stock quantity for a product (Holded API v2). BREAKING CHANGE from v1: `warehouse_id` is now required; `stock_variation` replaces `units`; optional `variant_id` and `description` added.
productIdrequiredvariant_iddescriptionwarehouse_idrequiredstock_variationrequiredList all treasury accounts (Holded API v2). Cursor-paginated: pass the previous response nextCursor as cursor. Response fields are snake_case; amounts are strings with decimal comma. WARNING: the `balance` field is a STATIC opening figure, not a live balance derived from transactions — do NOT rely on it for reconciliation or to compute the current cash position. Overlaps with list_bank_accounts/get_bank_account/create_bank_account (official treasury tools); consolidation planned for 2.1.
limitcursorfieldssummaryCreate a new treasury account (Holded API v2). Overlaps with list_bank_accounts/get_bank_account/create_bank_account (official treasury tools); consolidation planned for 2.1.
bicibannamerequiredbalanceGet a specific treasury account by ID (Holded API v2). WARNING: the `balance` field is a STATIC opening figure set on the account, not a live balance computed from transactions — do NOT use it for reconciliation or as the current cash position. Overlaps with list_bank_accounts/get_bank_account/create_bank_account (official treasury tools); consolidation planned for 2.1.
treasuryIdrequiredList expenses accounts (Holded API v2). Cursor-paginated: pass the previous response nextCursor as cursor. Response fields are snake_case; amounts are strings with decimal comma. Each account has `id` (Holded internal id), `name`, and `accountNum` (the PGC account number, e.g. 62900000). NOTE: this endpoint only returns expense/purchase accounts (PGC group 6). Income accounts (group 7, e.g. 700/705/759) are NOT listed here — fetch the full chart via get_chart_of_accounts, or read a known account by id via get_expenses_account.
limitcursorfieldssummaryCreate a new expenses account (Holded API v2)
codenamerequiredGet a single account by its Holded id (Holded API v2). Despite the "expenses" name, this endpoint serves ANY account (including income/group-7 accounts that list_expenses_accounts omits) when you already know its id.
accountIdrequiredUpdate an existing expenses account (Holded API v2)
codenameaccountIdrequiredDelete an expenses account (Holded API v2)
accountIdrequiredList numbering series for a specific document type (Holded API v2). Cursor-paginated: pass the previous response nextCursor as cursor. Response fields are snake_case; amounts are strings with decimal comma.
limitcursorfieldsdocTyperequiredsummaryCreate a new numbering serie (Holded API v2)
namerequiredprefixdocTyperequirednextNumberUpdate an existing numbering serie (Holded API v2)
nameprefixdocTyperequiredserieIdrequirednextNumberDelete a numbering serie (Holded API v2)
docTyperequiredserieIdrequiredList all sales channels (Holded API v2). Cursor-paginated: pass the previous response nextCursor as cursor. Response fields are snake_case; amounts are strings with decimal comma. Supports field filtering to reduce response size.
limitcursorfieldssummaryCreate a new sales channel (Holded API v2)
namerequiredGet a specific sales channel by ID (Holded API v2)
channelIdrequiredUpdate an existing sales channel (Holded API v2)
namechannelIdrequiredDelete a sales channel (Holded API v2)
channelIdrequiredList all payments (Holded API v2). Cursor-paginated: pass the previous response nextCursor as cursor. Response fields are snake_case; amounts are strings with decimal comma. NOTE: this endpoint is filtered to the ACTIVE fiscal year, so payments made in a prior year do NOT appear here even if they are linked to documents. For cross-year payment audits, read a document's payments via get_document_payments (the document `paymentsDetail`). Use start_date/end_date (YYYY-MM-DD) to filter by date — live-verified against v2.
limitcursorendtmpfieldssummaryend_datestarttmpstart_dateCreate a new payment (Holded API v2)
daysnamerequiredGet a specific payment by ID (Holded API v2)
paymentIdrequiredUpdate an existing payment (Holded API v2). IMPORTANT: Holded's PUT /payments/{id} REPLACES the record rather than merging, so any field omitted from the body is blanked. To prevent that, this tool first re-reads the current payment and merges your changes over it, preserving fields you did not pass (contactId, bankId, date, ...).
datedaysnameamountbankIdcontactIdpaymentIdrequiredDelete a payment (Holded API v2)
paymentIdrequiredGet all available taxes (Holded API v2). The v2 /taxes endpoint returns the complete tax list in one response (no cursor, no pagination). Supports `fields` to select specific fields and `summary` to return only the item count. Amounts are strings with decimal comma. Each tax has: `key` (the stable identifier, e.g. "s_iva_21"/"p_iva_21" — this is the value used in a document line's `taxes[]`), `id` (mirrors `key`), `name`, `amount` (the percentage as a string, e.g. "21"), `scope` ("sales" or "purchase"), `group` (e.g. "iva"), and `type`.
fieldssummaryList contact groups (Holded API v2). Cursor-paginated: pass the previous response nextCursor as cursor. Response fields are snake_case; amounts are strings with decimal comma.
limitcursorfieldssummaryCreate a new contact group (Holded API v2)
namerequiredGet a specific contact group by ID (Holded API v2)
groupIdrequiredUpdate an existing contact group (Holded API v2)
namegroupIdrequiredDelete a contact group (Holded API v2)
groupIdrequiredList all remittances (Holded API v2). Cursor-paginated: pass the previous response nextCursor as cursor. Response fields are snake_case; amounts are strings with decimal comma. NOTE: namespace relocated from /remittances to /treasury/remittances in v2.
limitcursorfieldssummaryGet a specific remittance by ID (Holded API v2). NOTE: route relocated to /treasury/remittances/{id} in v2.
remittanceIdrequiredList all services (Holded API v2). Cursor-paginated: pass the previous response nextCursor as cursor. Response fields are snake_case; amounts are strings with decimal comma. Supports field filtering to reduce response size.
limitcursorfieldssummaryCreate a new service (Holded API v2)
skutaxnamerequiredpricedescriptionGet a specific service by ID (Holded API v2)
serviceIdrequiredUpdate an existing service (Holded API v2)
skutaxnamepriceserviceIdrequireddescriptionDelete a service (Holded API v2)
serviceIdrequiredList all warehouses (Holded API v2). All warehouses are returned in a single call (no cursor pagination). Supports field filtering and summary mode.
fieldssummaryCreate a new warehouse (Holded API v2)
citynamerequiredaddresscountryprovincepostalCodeList all products stock in a specific warehouse (Holded API v2). Cursor-paginated: pass the previous response nextCursor as cursor. Server-paginated; use limit to control page size. Supports field filtering to reduce response size.
limitcursorfieldssummarywarehouseIdrequiredGet a specific warehouse by ID (Holded API v2)
warehouseIdrequiredUpdate an existing warehouse (Holded API v2). BREAKING CHANGE from v1: HTTP verb changed from PUT to PATCH.
citynameaddresscountryprovincepostalCodewarehouseIdrequiredDelete a warehouse (Holded API v2)
warehouseIdrequiredList time-tracking entries across all Holded projects (Projects API v2). Returns a cursor-paginated flat list of entries; pass the previous `nextCursor` as `cursor` to fetch the next page. Each entry contains timeId, duration (seconds), date (Unix seconds), approved (0/1), projectId, and projectName. The approvedOnly, startDate, and endDate filters are applied client-side on the current page — use pagination to iterate over the full dataset. Read-only.
limitcursorendDatestartDateapprovedOnlyList time-tracking entries for a single Holded project (Projects API v2). Returns a cursor-paginated flat list of entries for the given projectId. Pass the previous `nextCursor` as `cursor` to fetch the next page. The approvedOnly, startDate, and endDate filters are applied client-side on the current page. Read-only.
limitcursorendDateprojectIdrequiredstartDateapprovedOnlyGet a single time-tracking entry by project ID and time-tracking ID (Projects API v2). Read-only.
projectIdrequiredtimeTrackingIdrequiredGet accounting accounts (Holded API v2, GET /accounting-accounts). Returns every account with `num` (PGC number, e.g. 40000000), `name`, `group`, `debit`, `credit`, and `balance`. Unlike `list_expenses_accounts` (group-6 only), this includes all groups (assets, liabilities, income, expenses). Cursor-paginated: pass `nextCursor` from the previous response as `cursor`. Optional annex filters: `archived` (include archived accounts), `start_date`/`end_date` (ISO 8601, filter by activity period), `include_empty` (include zero-balance accounts). See also: `list_accounting_accounts` in ledger tools — both tools target the same v2 endpoint; consolidation is planned for release 2.1. Read-only.
limitcursorarchivedend_datestart_dateinclude_emptyGet ledger entries / journal (asientos) for a date range (Holded API v2, GET /ledger-entries). Returns one row per ledger line with entryNumber, line, timestamp, type (collect/payment/purchase/…), description, account (PGC num), debit, and credit. This is the authoritative source for balance-sheet and tax-return figures. Date arguments (at least one form of each bound is required — the v2 API returns 422 without both): • Primary form : `start_date` / `end_date` — ISO 8601 date strings (YYYY-MM-DD) • Legacy form : `starttmp` / `endtmp` — Unix timestamps in seconds; converted automatically to ISO If both forms are supplied for the same bound, the ISO string takes precedence. Cursor-paginated: pass `nextCursor` from a previous response as `cursor` to retrieve subsequent pages. Large date ranges may require multiple pages. Set `groupByEntry` to nest lines into full double-entry entries with per-entry debit/credit totals (applied page-scoped). See also: `list_ledger_entries` in ledger tools — both tools target the same v2 endpoint. Read-only.
limitcursorendtmpend_datestarttmpstart_dategroupByEntryList employees (Holded API v2, section Equipo y RRHH). Cursor-paginated: pass the previous response `nextCursor` as `cursor` to fetch the next page.
limitcursorGet a single employee by ID (Holded API v2).
employeeIdrequiredWRITE: creates a real employee record in Holded (API v2). `data` is sent verbatim as the request body — see https://www.holded.com/es/desarrolladores/referencia-api (Empleados → Crear) for the payload fields (name, email, etc.).
datarequiredWRITE: updates a real employee record in Holded (API v2). `data` is sent verbatim as the request body — see https://www.holded.com/es/desarrolladores/referencia-api (Empleados → Actualizar).
datarequiredemployeeIdrequiredDESTRUCTIVE: permanently deletes an employee record in Holded (API v2). This cannot be undone.
employeeIdrequiredGet the contract details of an employee (Holded API v2). A 404 response means the employee has no contract configured in Holded, not that the employee ID is wrong.
employeeIdrequiredWRITE: updates an employee's contract in Holded (API v2) — affects real HR/payroll data. `data` is sent verbatim as the request body — see https://www.holded.com/es/desarrolladores/referencia-api (Empleados → Actualizar contrato).
datarequiredemployeeIdrequiredWRITE: registers a clock-in for an employee in Holded time tracking (API v2). Affects real working-time records.
employeeIdrequiredWRITE: registers a clock-out for an employee in Holded time tracking (API v2).
employeeIdrequiredWRITE: starts a pause in the current working session of an employee (Holded API v2).
employeeIdrequiredWRITE: ends the current pause of an employee working session (Holded API v2).
employeeIdrequiredList time-tracking records (Holded API v2). Without `employeeId` lists all records (/employee-times); with `employeeId` lists only that employee (/employees/{id}/times). Cursor-paginated.
limitcursoremployeeIdGet a single time-tracking record by ID (Holded API v2).
timeIdrequiredWRITE: creates a manual time-tracking record for an employee (Holded API v2). `data` is sent verbatim as the request body — see https://www.holded.com/es/desarrolladores/referencia-api (Control horario → Crear registro).
datarequiredemployeeIdrequiredWRITE: updates a time-tracking record (Holded API v2). `data` is sent verbatim as the request body — see https://www.holded.com/es/desarrolladores/referencia-api (Control horario → Actualizar).
datarequiredtimeIdrequiredDESTRUCTIVE: permanently deletes a time-tracking record in Holded (API v2). This cannot be undone.
timeIdrequiredList payroll salary records (Holded API v2, requires scope accounting:payrolls.read). Each record has employee info, earnings/deductions lines, totals and payment status (PENDING, PAID, PARTIALLY_PAID). Cursor-paginated.
limitcursorGet a payroll salary record by ID (Holded API v2, scope accounting:payrolls.read). Returns line-by-line earnings and deductions, accounting accounts, totals and payment status.
salaryRecordIdrequiredWRITE: creates a real payroll record in Holded (API v2) — affects accounting and HR data. Use get_salary_record_defaults first to obtain a valid base payload. `data` is sent verbatim as the request body — see https://www.holded.com/es/desarrolladores/referencia-api (Registros de nómina → Crear).
datarequiredWRITE: updates a payroll record in Holded (API v2) — affects accounting and HR data. `data` is sent verbatim as the request body — see https://www.holded.com/es/desarrolladores/referencia-api (Registros de nómina → Actualizar).
datarequiredsalaryRecordIdrequiredDESTRUCTIVE: permanently deletes a payroll record in Holded (API v2). This cannot be undone and affects accounting data.
salaryRecordIdrequiredGet the default data for creating a payroll record (Holded API v2). Useful as a base payload for create_salary_record.
Takes no parameters.
List journal/ledger entries (Holded API v2). Cursor-paginated: pass the previous response `nextCursor` as `cursor`. Optionally filter by `start_date`/`end_date` (ISO 8601, e.g. `2025-01-01`) — the v2 endpoint returns 422 if neither date is provided. For the read-only daily-ledger tool with groupByEntry support and Unix-timestamp backward compat see get_daily_ledger.
limitcursorend_datestart_dateWRITE: creates a real journal entry in Holded accounting (API v2). Incorrect entries directly distort the company books — double-check accounts and amounts. `data` is sent verbatim as the request body — see https://www.holded.com/es/desarrolladores/referencia-api (Contabilidad → Crear asiento).
datarequiredList accounting accounts (Holded API v2). Cursor-paginated. For the v1 read-only chart of accounts see get_chart_of_accounts.
limitcursorWRITE: creates a real accounting account in the Holded chart of accounts (API v2). `data` is sent verbatim as the request body — see https://www.holded.com/es/desarrolladores/referencia-api (Contabilidad → Crear cuenta).
datarequiredList treasury bank accounts (Holded API v2, official endpoint). Cursor-paginated.
limitcursorGet a treasury bank account by ID (Holded API v2).
accountIdrequiredWRITE: creates a real treasury bank account in Holded (API v2). `data` is sent verbatim as the request body — see https://www.holded.com/es/desarrolladores/referencia-api (Tesorería → Crear cuenta).
datarequiredWRITE: updates a treasury bank account in Holded (API v2). `data` is sent verbatim as the request body — see https://www.holded.com/es/desarrolladores/referencia-api (Tesorería → Actualizar cuenta).
datarequiredaccountIdrequiredDESTRUCTIVE: permanently deletes a treasury bank account in Holded (API v2). Prefer archive_bank_account to keep history. This cannot be undone.
accountIdrequiredWRITE: archives a treasury bank account in Holded (API v2). Reversible alternative to delete_bank_account.
accountIdrequiredList bank movements of a treasury account (Holded API v2, official endpoint — replaces the experimental internal banking tools). Cursor-paginated.
limitcursoraccountIdrequiredWRITE: creates a real bank movement in a treasury account (Holded API v2). `data` is sent verbatim as the request body — see https://www.holded.com/es/desarrolladores/referencia-api (Tesorería → Crear movimiento).
datarequiredaccountIdrequiredWRITE: reconciles a bank movement against documents/entries (Holded API v2, official endpoint — replaces the experimental reconcile_bank_transaction from the internal API when v2 is enabled). `data` is sent verbatim as the request body — see https://www.holded.com/es/desarrolladores/referencia-api (Tesorería → Conciliar).
datarequiredaccountIdrequiredmovementIdrequiredList cash movements of a treasury account (Holded API v2). Cursor-paginated. This endpoint applies to cash-type treasury accounts only; bank and card account types return 404.
limitcursoraccountIdrequiredList cashflow invoicing forecasts (Holded API v2). Cursor-paginated.
limitcursorGet a cashflow invoicing forecast by ID (Holded API v2).
forecastIdrequiredWRITE: creates an invoicing forecast in Holded cashflow (API v2). `data` is sent verbatim as the request body — see https://www.holded.com/es/desarrolladores/referencia-api (Tesorería → Previsiones).
datarequiredWRITE: updates an invoicing forecast in Holded cashflow (API v2). `data` is sent verbatim as the request body — see https://www.holded.com/es/desarrolladores/referencia-api (Tesorería → Previsiones).
datarequiredforecastIdrequiredDESTRUCTIVE: permanently deletes an invoicing forecast in Holded cashflow (API v2).
forecastIdrequired90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
npm install -g @nubiia/mcp-holdedgit clone https://github.com/nubiia-dev/mcp-holded.gitcd mcp-holdednpm installnpm run build# Recommended — primary key nameexport HOLDED_API_KEY=pat_your_v2_key_here
# Alternative — accepted as an alias; wins over HOLDED_API_KEY if both are setexport HOLDED_API_KEY_V2=sk_live_your_v2_key_hereexport TENANT_1_NAME=company-aexport TENANT_1_API_KEY=pat_key_for_company_aexport TENANT_2_NAME=company-bexport TENANT_2_API_KEY=sk_live_key_for_company_b{ "mcpServers": { "holded": { "command": "npx", "args": ["-y", "@nubiia/mcp-holded"], "env": { "HOLDED_API_KEY": "pat_your_v2_key_here" } } }}{ "mcpServers": { "holded": { "command": "node", "args": ["/path/to/mcp-holded/dist/index.js"], "env": { "HOLDED_API_KEY": "pat_your_v2_key_here" } } }}{ "items": [...], "nextCursor": "opaque-string-or-null", "hasMore": true}https://api.holded.com/api/Authorization: Bearer pat_your_v2_key_here# Install dependenciesnpm install
# Buildnpm run build
# Watch modenpm run dev