MCP Server

io.github.energio-es/holded-mcp MCP Server

Name: io.github.energio-es/holded-mcp MCP Server
Author: io.github.energio-es

io.github.energio-es/holded-mcp

Repository Registry

What is the io.github.energio-es/holded-mcp MCP server?

MCP server for Holded — invoicing, accounting, CRM, projects, and team

How to install io.github.energio-es/holded-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

HOLDED_API_KEY
required
Your Holded API key. Get it from https://app.holded.com/api
HOLDED_MODULES
Comma-separated list of modules to enable (invoicing, crm, projects, accounting, team). All enabled by default.
HOLDED_RATE_LIMIT_PER_SECOND
API rate limit in requests per second. Default: 10.
HOLDED_DEBUG
Set to 'true' to enable debug logging for API requests.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "holded-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@energio/holded-mcp"
      ],
      "env": {
        "HOLDED_API_KEY": "<YOUR_HOLDED_API_KEY>",
        "HOLDED_MODULES": "<YOUR_HOLDED_MODULES>",
        "HOLDED_RATE_LIMIT_PER_SECOND": "<YOUR_HOLDED_RATE_LIMIT_PER_SECOND>",
        "HOLDED_DEBUG": "<YOUR_HOLDED_DEBUG>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "holded-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@energio/holded-mcp"
      ],
      "env": {
        "HOLDED_API_KEY": "<YOUR_HOLDED_API_KEY>",
        "HOLDED_MODULES": "<YOUR_HOLDED_MODULES>",
        "HOLDED_RATE_LIMIT_PER_SECOND": "<YOUR_HOLDED_RATE_LIMIT_PER_SECOND>",
        "HOLDED_DEBUG": "<YOUR_HOLDED_DEBUG>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "holded-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@energio/holded-mcp"
      ],
      "env": {
        "HOLDED_API_KEY": "<YOUR_HOLDED_API_KEY>",
        "HOLDED_MODULES": "<YOUR_HOLDED_MODULES>",
        "HOLDED_RATE_LIMIT_PER_SECOND": "<YOUR_HOLDED_RATE_LIMIT_PER_SECOND>",
        "HOLDED_DEBUG": "<YOUR_HOLDED_DEBUG>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "holded-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@energio/holded-mcp"
      ],
      "env": {
        "HOLDED_API_KEY": "<YOUR_HOLDED_API_KEY>",
        "HOLDED_MODULES": "<YOUR_HOLDED_MODULES>",
        "HOLDED_RATE_LIMIT_PER_SECOND": "<YOUR_HOLDED_RATE_LIMIT_PER_SECOND>",
        "HOLDED_DEBUG": "<YOUR_HOLDED_DEBUG>"
      }
    }
  }
}

Claude Code

claude mcp add holded-mcp --env HOLDED_API_KEY=<YOUR_HOLDED_API_KEY> --env HOLDED_MODULES=<YOUR_HOLDED_MODULES> --env HOLDED_RATE_LIMIT_PER_SECOND=<YOUR_HOLDED_RATE_LIMIT_PER_SECOND> --env HOLDED_DEBUG=<YOUR_HOLDED_DEBUG> -- npx -y @energio/holded-mcp