# Frihet ERP

Lets an AI client work with Frihet for invoices, expenses, tax workflows, and banking data. Useful when ERP tasks need to run from an IDE.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: Frihet-io
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Frihet-io/frihet-mcp
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/frihet-erp

## What it does

Frihet ERP connects an MCP client to Frihet so an assistant can handle business records through natural-language requests. It can create invoices, inspect expenses, work with customers and products, and support ES/EU fiscal flows such as VeriFactu, TicketBAI, and Facturae.

You can use the hosted HTTP endpoint or run the package locally with `npx @frihet/mcp-server`. A demo mode provides sample records for testing: writes are simulated, nothing is stored, and fiscal actions are not submitted to tax authorities. Real workspace data requires a Frihet API key.

The catalogue includes 156 canonical operations. Available tools and resources vary by connection profile, so the local and hosted versions do not expose the same surface.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.frihet.io/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http erp https://mcp.frihet.io/mcp
```

2. **Platform CLI**
```bash
claude mcp add frihet-erp -- npx -y @frihet/mcp-server
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add frihet-erp --url https://mcp.frihet.io/mcp
```

2. **Platform CLI**
```bash
codex mcp add frihet-erp -- npx -y @frihet/mcp-server
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "frihet-erp": {
            "url": "https://mcp.frihet.io/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "frihet-erp": {
            "command": "npx",
            "args": [
                "-y",
                "@frihet/mcp-server"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "frihet-erp": {
            "type": "http",
            "url": "https://mcp.frihet.io/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "frihet-erp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@frihet/mcp-server"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http frihet-erp https://mcp.frihet.io/mcp
```

2. **Platform CLI**
```bash
gemini mcp add frihet-erp npx -y @frihet/mcp-server
```

## When to use it
- create an invoice from a chat request
- search company expenses
- inspect customer and product records
- handle an ES/EU tax workflow
- retrieve bank account information

## Example prompts
- Create an invoice for TechStart SL for 40 consulting hours at 75 EUR per hour.
- Find the company’s expenses and group them by category.
- Show the available customer and bank account records.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44591
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5469
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2197
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md