MCP Holded
An MCP server for the Holded API v2 providing 13 hierarchical tools, 7 resources, and 6 prompts. It covers contacts, invoicing, purchases, payments, treasury, accounting, catalog, team, CRM, projects, calendar, inbox, and webhooks. It features Zod validation, retries on reads, and a confirmation gate on destructive operations.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Manage contacts and CRM data
- Create and process sales and purchase invoices
- Handle payments and treasury operations
- Run accounting workflows like VAT summary and bank reconciliation
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
@t4dhg/mcp-holded 2.1.1
{
"version": "2.1.1",
"transport": "stdio",
"identifier": "@t4dhg/mcp-holded",
"runtimeHint": "npx",
"registryType": "npm",
"registryBaseUrl": "https://registry.npmjs.org",
"environmentVariables": [
{
"name": "HOLDED_API_KEY",
"isRequired": true,
"description": "Holded v2 Personal Access Token (pat_<id>_<secret>), created under Settings, Developers, API. A v1 key is rejected at startup."
},
{
"name": "HOLDED_BASE_URL",
"description": "Override the API base URL (default: https://api.holded.com/api/v2)"
},
{
"name": "HOLDED_TIMEOUT_MS",
"description": "Per-request timeout in milliseconds (default: 30000)"
},
{
"name": "HOLDED_MAX_RETRIES",
"description": "Retry attempts for GET requests; writes are never retried (default: 3)"
},
{
"name": "DEBUG",
"description": "Log requests to stderr (default: false)"
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"mcp-holded": {
"command": "npx",
"args": [
"-y",
"@t4dhg/mcp-holded@2.1.1"
],
"env": {
"HOLDED_API_KEY": "<YOUR_HOLDED_API_KEY>",
"HOLDED_BASE_URL": "<YOUR_HOLDED_BASE_URL>",
"HOLDED_TIMEOUT_MS": "<YOUR_HOLDED_TIMEOUT_MS>",
"HOLDED_MAX_RETRIES": "<YOUR_HOLDED_MAX_RETRIES>",
"DEBUG": "<YOUR_DEBUG>"
}
}
}
}Cline
{
"mcpServers": {
"mcp-holded": {
"command": "npx",
"args": [
"-y",
"@t4dhg/mcp-holded@2.1.1"
],
"env": {
"HOLDED_API_KEY": "<YOUR_HOLDED_API_KEY>",
"HOLDED_BASE_URL": "<YOUR_HOLDED_BASE_URL>",
"HOLDED_TIMEOUT_MS": "<YOUR_HOLDED_TIMEOUT_MS>",
"HOLDED_MAX_RETRIES": "<YOUR_HOLDED_MAX_RETRIES>",
"DEBUG": "<YOUR_DEBUG>"
}
}
}
}VS Code
{
"servers": {
"mcp-holded": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@t4dhg/mcp-holded@2.1.1"
],
"env": {
"HOLDED_API_KEY": "<YOUR_HOLDED_API_KEY>",
"HOLDED_BASE_URL": "<YOUR_HOLDED_BASE_URL>",
"HOLDED_TIMEOUT_MS": "<YOUR_HOLDED_TIMEOUT_MS>",
"HOLDED_MAX_RETRIES": "<YOUR_HOLDED_MAX_RETRIES>",
"DEBUG": "<YOUR_DEBUG>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"mcp-holded": {
"command": "npx",
"args": [
"-y",
"@t4dhg/mcp-holded@2.1.1"
],
"env": {
"HOLDED_API_KEY": "<YOUR_HOLDED_API_KEY>",
"HOLDED_BASE_URL": "<YOUR_HOLDED_BASE_URL>",
"HOLDED_TIMEOUT_MS": "<YOUR_HOLDED_TIMEOUT_MS>",
"HOLDED_MAX_RETRIES": "<YOUR_HOLDED_MAX_RETRIES>",
"DEBUG": "<YOUR_DEBUG>"
}
}
}
}Let your agent find its tools
Find servers like MCP Holded from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.