Holded API를 위한 Model Context Protocol (MCP) 서버. 이 서버는 Claude와 같은 AI 조수가 Holded’s invoicing, 회계, 연락처, 제품, 재무, HR, 시간 추적 등과 상호 작용합니다.

내장 및 유지 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.

특징

이 MCP 서버는 지원된 모든 단위의 Holded API v2에 접근을 제공합니다:

• Documents (16 도구): 생성, 목록, 업데이트, 삭제 송장, 견적, 신용 메모, 등. 또한 지불, 보내, PDF, 배 품목 및 더 많은 것을 얻으십시오.
• 문의 (7 도구): 고객 및 공급 업체 관리.
• 제품 (9개의 공구): 이미지 및 주식을 포함한 전체 제품 관리.
• ** 부동산 ** (3 도구): 레거시 treasury 계정 관리. -Treasury v2 (15 도구): 은행 계좌, 은행 이동, 현금 운동, 간호 예측 및 재구성. -Expenses 계정 (5 도구): 처리 비용 계정 범주.
• Numbering Series (4개의 도구): 문서 번호 구성.
• ** 판매 채널 ** (5 도구) : 판매 채널 관리.

MCP Holded

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.

Features

This MCP server provides access to the Holded API v2 across all supported modules:

• Documents (16 tools): Create, list, update, delete invoices, estimates, credit notes, etc. Also pay, send, get PDF, ship items, and more.
• Contacts (7 tools): Manage clients and suppliers with attachments.
• Products (9 tools): Full product management including images and stock.
• Treasuries (3 tools): Manage legacy treasury accounts.
• Treasury v2 (15 tools): Bank accounts, bank movements, cash movements, invoicing forecasts and reconciliation.
• Expenses Accounts (5 tools): Handle expense account categories.
• Numbering Series (4 tools): Configure document numbering.
• Sales Channels (5 tools): Manage sales channels.
• Warehouses (6 tools): Warehouse management.
• Payments (5 tools): Payment method configuration.
• Taxes (1 tool): Get available taxes.
• Contact Groups (5 tools): Organize contacts into groups.
• Remittances (2 tools): Access remittance data.
• Services (5 tools): Manage services.
• Time Tracking (3 tools): List time-tracking entries and project times (read and write).
• Accounting (2 tools, read-only): Get the chart of accounts and the daily ledger.
• Ledger (4 tools): List and create accounting/ledger entries.
• Team/HR (22 tools): Employee management, payroll records, employee time entries and clock in/out.

Total: 119 tools — all registered unconditionally once a valid v2 key is configured.

Installation

Prerequisites

• Node.js 22.14 or higher
• A Holded account with API access
• A Holded API v2 key (pat_… or sk_live_…) — generate it in Holded → Settings → API

Install from npm

npm install -g @nubiia/mcp-holded

Install from source

git clone https://github.com/nubiia-dev/mcp-holded.git
cd mcp-holded
npm install
npm run build

Configuration

Environment Variables