# @frihet/mcp-server [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/Frihet-io/frihet-mcp  
**GitHub Stars:** 13  
**npm Downloads (last month):** 1277  
**Views:** 12  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/-frihet-mcp-server

## Description
AI-native business management — invoices, expenses, clients, products, and quotes. 31 tools for Claude, Cursor, Windsurf, and Cline.

## Tools
Capabilities this server exposes over MCP:

- **group**
- **limit**

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-server": {
    "command": "npx",
    "args": ["-y","@frihet/mcp-server"],
    "env": {
      "FRIHET_DEMO": ""
    }
  }
}
```

**Requires environment variables:** `FRIHET_DEMO` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What @frihet/mcp-server does

@frihet/mcp-server gives AI assistants an MCP interface to Frihet business-management data and operations. It is intended for conversational work such as creating an invoice, checking expenses, finding a client, or managing products from an IDE or chat client.

The catalogue contains 156 canonical operations, along with fiscal aliases, prompts, and resources. The available operation families cover core business records including invoices, expenses, clients, products, quotes, and bank accounts. The broader catalogue also includes HR, payroll, permissions, period closing, webhooks, and fiscal processes such as electronic invoicing, VeriFactu, TicketBAI, and FACe.

## How it works

The package runs as an MCP server and can be launched locally with npm. AI clients discover its tools through MCP and send structured requests based on natural-language instructions. The local profile includes API-backed workspace resources, while the hosted Worker exposes a smaller set of static resources and grouped tools.

A hosted connection is available at `https://mcp.frihet.io/mcp`. That route supports OAuth or an API key. The package is also listed in the official MCP Registry as `io.frihet/erp`.

## Setup and configuration

The package can be started with:

```bash
npx -y @frihet/mcp-server
```

For an offline trial, set demo mode before launching:

```bash
FRIHET_DEMO=1 npx -y @frihet/mcp-server
```

Demo mode uses example Spanish business data, including invoices with IVA or IGIC, expenses, clients, products, and a bank account. Records use `demo_`-prefixed identifiers. Reads return fixtures, writes are simulated, and no data is saved or sent over the network. Fiscal actions also return simulations rather than submissions to a tax authority.

For real workspace data, obtain an API key from Frihet under the app's Settings area and configure the local MCP client according to its standard server setup. The package requires a supported Node.js 22.x, 24.x, or 26.x runtime; the published compatibility badge lists minimum patch versions for those major releases.

## Tools and capabilities

The server supports operations for:

- Creating and querying invoices and quotes
- Managing expenses, clients, products, and bank accounts
- Handling HR, payroll, permissions, and accounting period close tasks
- Working with electronic invoicing and Spanish fiscal workflows
- Testing webhook behavior
- Supplying prompts and MCP resources alongside tools

The exact profile depends on the connection method. The local package exposes 11 resources, while the hosted profile exposes seven static resources. A separately reviewed OpenAI profile exposes a reduced tool set.

## Limitations and notes

Demo mode is for testing only: it does not persist changes and cannot make real fiscal submissions. Catalogue membership does not guarantee that every operation is enabled for every Frihet workspace.

The hosted and local profiles are not identical. API-backed workspace resources are available only in the local profile, and the hosted profile adds discovery tools. Marketplace or registry listings should not be treated as proof of approval or vendor endorsement; configure the server directly through npm or the hosted MCP route.

_Full upstream README: https://allmcps.com/mcp/-frihet-mcp-server/readme_