Skip to content
MCP server

MCP Holded

Local server for Holded's v2 API: invoicing, accounting, CRM, projects and payroll

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
4.0.0
Listing updated
today

Similar MCP servers

About MCP Holded

MCP Holded is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

This is a community project, not made or supported by Holded. It runs locally over stdio with a Holded v2 personal access token (pat_ prefix) created under Settings, Developers, API; classic v1 keys are rejected at startup, since Holded deprecated that API.

Rather than one tool per endpoint, it groups operations into thirteen tools with an action parameter, so the model's tool list stays small. They cover contacts, sales and purchase documents, payments, treasury, accounting, catalogue, team, CRM, projects, calendar, inbox and webhooks. It also ships seven MCP resources, which carry your account's tax keys, numbering series, payment methods and chart of accounts, and six prompts for aged receivables, VAT summaries, bank reconciliation, statements and month-end close.

Anything that deletes, overwrites, approves or emails requires confirm: true. GET requests retry up to three times by default, but writes are never retried. Released under MIT; needs Node.js 18 or newer.

Install

Run in a terminal

claude mcp add mcp-holded --env HOLDED_API_KEY='<HOLDED_API_KEY>' -- npx -y @t4dhg/mcp-holded

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • HOLDED_API_KEYHolded v2 Personal Access Token (pat_<id>_<secret>), created under Settings, Developers, API. A v1 key is rejected at startup.Required
  • HOLDED_BASE_URLOverride the API base URL (default: https://api.holded.com/api/v2)
  • HOLDED_TIMEOUT_MSPer-request timeout in milliseconds (default: 30000)
  • HOLDED_MAX_RETRIESRetry attempts for GET requests; writes are never retried (default: 3)
  • DEBUGLog requests to stderr (default: false)

What it does

Thirteen action-based tools
Groups many operations behind a few tools to save context.
Confirmation gate
Destructive operations require confirm: true.
Account resources
Exposes tax keys, numbering series, payment methods and chart of accounts.
Workflow prompts
Includes prompts for aged receivables, VAT, reconciliation and month-end close.
Response validation
Validates typed operations with Zod schemas.

Good for

  • Review aged receivables
  • Prepare a VAT summary
  • Reconcile bank transactions
  • Run month-end close checks
  • Look up contacts and invoices by conversation

Pricing

Open source

MIT licence; requires a Holded account

MCP Holded FAQ

Is it official?

No. It is a community project not affiliated with or endorsed by Holded.

Which API version does it use?

Holded API v2 only; v1 keys are rejected.

How does it authenticate?

With a HOLDED_API_KEY personal access token in the format pat_<id>_<secret>.

Are writes retried?

No. GET requests are retried, writes never are.

Is MCP Holded free?

Yes. MCP Holded is open source, so you can use and self-host it for free.

How do I add MCP Holded to Claude Code?

Run this command in your terminal: claude mcp add mcp-holded --env HOLDED_API_KEY='<HOLDED_API_KEY>' -- npx -y @t4dhg/mcp-holded

What are the best alternatives to MCP Holded?

The closest alternatives to MCP Holded are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Maildignity, Calven and Budget Tracker.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers