NestDaddy

MCP Holded

io.github.t4dhg/mcp-holded ยท v4.0.0

MCP server for Holded (Spanish ERP): invoicing, accounting, treasury, CRM, projects, payroll.

Connect Runs on your machine

Terminal
claude mcp add mcp-holded -e HOLDED_API_KEY=<HOLDED_API_KEY> -e HOLDED_BASE_URL=<HOLDED_BASE_URL> -e HOLDED_TIMEOUT_MS=<HOLDED_TIMEOUT_MS> -e HOLDED_MAX_RETRIES=<HOLDED_MAX_RETRIES> -e DEBUG=<DEBUG> -- npx -y @t4dhg/[email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-holded": {
      "command": "npx",
      "args": [
        "-y",
        "@t4dhg/[email protected]"
      ],
      "env": {
        "HOLDED_API_KEY": "<HOLDED_API_KEY>",
        "HOLDED_BASE_URL": "<HOLDED_BASE_URL>",
        "HOLDED_TIMEOUT_MS": "<HOLDED_TIMEOUT_MS>",
        "HOLDED_MAX_RETRIES": "<HOLDED_MAX_RETRIES>",
        "DEBUG": "<DEBUG>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "mcp-holded": {
      "command": "npx",
      "args": [
        "-y",
        "@t4dhg/[email protected]"
      ],
      "env": {
        "HOLDED_API_KEY": "<HOLDED_API_KEY>",
        "HOLDED_BASE_URL": "<HOLDED_BASE_URL>",
        "HOLDED_TIMEOUT_MS": "<HOLDED_TIMEOUT_MS>",
        "HOLDED_MAX_RETRIES": "<HOLDED_MAX_RETRIES>",
        "DEBUG": "<DEBUG>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "mcp-holded": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@t4dhg/[email protected]"
      ],
      "env": {
        "HOLDED_API_KEY": "<HOLDED_API_KEY>",
        "HOLDED_BASE_URL": "<HOLDED_BASE_URL>",
        "HOLDED_TIMEOUT_MS": "<HOLDED_TIMEOUT_MS>",
        "HOLDED_MAX_RETRIES": "<HOLDED_MAX_RETRIES>",
        "DEBUG": "<DEBUG>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
HOLDED_API_KEY
Required, secret
Holded v2 Personal Access Token (pat_<id>_<secret>), created under Settings, Developers, API. A v1 key is rejected at startup.
HOLDED_BASE_URL
Optional
Override the API base URL (default: https://api.holded.com/api/v2)
HOLDED_TIMEOUT_MS
Optional
Per-request timeout in milliseconds (default: 30000)
HOLDED_MAX_RETRIES
Optional
Retry attempts for GET requests; writes are never retried (default: 3)
DEBUG
Optional
Log requests to stderr (default: false)

Details

Package@t4dhg/[email protected] (NPM, stdio)
First published10 Nov 2026
Last updated10 Nov 2026
Registry nameio.github.t4dhg/mcp-holded

More finance and crypto servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.