# MCP Holded

> MCP Holded is an open-source MCP server for finance and payments. Local server for Holded's v2 API: invoicing, accounting, CRM, projects and payroll. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/t4dhg/mcp-holded
- **MCP Registry name:** io.github.t4dhg/mcp-holded
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [sales and CRM](https://ai-powered.com/categories/sales-and-crm)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Maildignity](https://ai-powered.com/mcp/maildignity-2): Maildignity is a freemium MCP server for sales and crm.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/mcp-holded-2
