Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y @nubiia/[email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
HOLDED_API_KEY=<secret> claude mcp add io.github.nubiia-dev-mcp-holded -- npx -y @nubiia/mcp-holded@2.0.3รันในเทอร์มินัล
{ "mcpServers": { "io.github.nubiia-dev-mcp-holded": { "command": "npx", "args": [ "-y", "@nubiia/[email protected]" ], "env": { "HOLDED_API_KEY": "<secret>" } } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิด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 → APInpm install -g @nubiia/mcp-holded
git clone https://github.com/nubiia-dev/mcp-holded.git
cd mcp-holded
npm install
npm run build
All tools call the Holded API v2 (Bearer auth, cursor pagination). You need a single v2 key:
# Recommended — primary key name
export HOLDED_API_KEY=pat_your_v2_key_here
# Alternative — accepted as an alias; wins over HOLDED_API_KEY if both are set
export HOLDED_API_KEY_V2=sk_live_your_v2_key_here
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:
export TENANT_1_NAME=company-a
export TENANT_1_API_KEY=pat_key_for_company_a
export TENANT_2_NAME=company-b
export TENANT_2_API_KEY=sk_live_key_for_company_b
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
{
"mcpServers": {
"holded": {
"command": "npx",
"args": ["-y", "@nubiia/mcp-holded"],
"env": {
"HOLDED_API_KEY": "pat_your_v2_key_here"
}
}
}
}
Or if installed from source:
{
"mcpServers": {
"holded": {
"command": "node",
"args": ["/path/to/mcp-holded/dist/index.js"],
"env": {
"HOLDED_API_KEY": "pat_your_v2_key_here"
}
}
}
}
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:
{
"items": [...],
"nextCursor": "opaque-string-or-null",
"hasMore": true
}
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:
https://api.holded.com/api/
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:
Authorization: Bearer pat_your_v2_key_here
List endpoints use cursor-based pagination via limit and cursor arguments (see Migrating from 1.x).
# Install dependencies
npm install
# Build
npm run build
# Watch mode
npm run dev
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]
Complete Holded Invoice API integration with 72 MCP tools for invoices, contacts, products, and more
{ "mcpServers": { "io.github.nubiia-dev-mcp-holded": { "command": "npx", "args": [ "-y", "@nubiia/[email protected]" ], "env": { "HOLDED_API_KEY": "<secret>" } } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ผู้เผยแพร่ระบุตัวแปรสภาพแวดล้อมเหล่านี้: HOLDED_API_KEY
MCP Holded ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-10 Complete Holded Invoice API integration with 72 MCP tools for invoices, contacts, products, and more