Holded MCP Server

by t4dhgio.github.t4dhg/mcp-holdedv2.1.1

MCP server for the Holded API v2: contacts, sales and purchase documents, payments, treasury, accounting, catalog, team, CRM, projects, calendar, inbox and webhooks, with confirmation gates on every destructive operation.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active32d ago

Install Holded MCP server

claude mcp add holded-t4dhg -e HOLDED_API_KEY='<holded-api-key>' -- npx -y @t4dhg/mcp-holded

{
  "mcpServers": {
    "holded-t4dhg": {
      "command": "npx",
      "args": [
        "-y",
        "@t4dhg/mcp-holded"
      ],
      "env": {
        "HOLDED_API_KEY": "<holded-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "holded-t4dhg": {
      "command": "npx",
      "args": [
        "-y",
        "@t4dhg/mcp-holded"
      ],
      "env": {
        "HOLDED_API_KEY": "<holded-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "holded-t4dhg": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@t4dhg/mcp-holded"
      ],
      "env": {
        "HOLDED_API_KEY": "<holded-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "holded-t4dhg": {
      "command": "npx",
      "args": [
        "-y",
        "@t4dhg/mcp-holded"
      ],
      "env": {
        "HOLDED_API_KEY": "<holded-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

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

Freshness

Active — last maintenance signal 32d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-08 · 32d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-08 · 32d ago · official registry · v2.1.1

FAQ

›How do I install the Holded MCP server in Claude Code?

Run: claude mcp add holded-t4dhg -e HOLDED_API_KEY='<holded-api-key>' -- npx -y @t4dhg/mcp-holded. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Holded require an API key?

Yes. It expects HOLDED_API_KEY, of which 1 is a secret.

›Can I use Holded as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Holded in the official MCP registry?

Yes, as io.github.t4dhg/mcp-holded.