frihet-erp

AI-native MCP server for business management. Servidor MCP nativo con IA para gestión empresarial.

Works with Claude · ChatGPT · Cursor · Windsurf · Cline · Antigravity · Codex · Copilot · Gemini CLI — and any MCP-compatible client.

---

Distribution

Reviewed 2026-10-31. A directory entry is not proof of a working installation, vendor endorsement, or adoption. Package releases, hosted deployments and reviewed app versions are independent.

Use Frihet

Channel	Availability	Entry point
npm	Published package; see its own release version	npm · npx @frihet/mcp-server
Remote MCP	Hosted connection route; OAuth or API key	https://mcp.frihet.io/mcp
ChatGPT app	Published 1.0.2, confirmed by the maintainer; not the separate 1.0.3 candidate	Frihet in ChatGPT

Find Frihet

These are discovery links, not a count of independent integrations. Some third-party descriptions and cached copies are outdated.

Surface	Evidence at review	Entry
Official MCP Registry	Specific registry entry indexed	io.frihet/erp
GitHub MCP Registry	Listing content retrieved; not a GitHub-verified connector claim	Frihet ERP
ToolSDK MCP Registry	Entry read in upstream repository	Registry entry
Glama	Specific listing indexed; summary needs refresh	Listing
Smithery	Specific listing indexed; live recheck blocked	Listing
mcpservers.org	Listing content retrieved; description outdated	Listing
Cursor Directory	Community listing retrieved; separate from the official Cursor Marketplace	Listing
mcp.so	Specific listing indexed; current installation not verified	Listing

Frihet also appears in punkpeye/awesome-mcp-servers, TensorBlock/awesome-mcp-servers and ever-works/awesome-mcp-servers. Their retrieved descriptions still use an old tool count; the ever-works entry also links to a non-canonical repository URL. Use this repository's install instructions rather than copying those descriptions.

Pending or not reverified

• Docker: submission PR #1711 remains open; do not describe it as published in Docker's catalog.
• Cline: submission #2053 remains open; client compatibility is not marketplace approval.
• PulseMCP: historically reported; a current primary listing was not retrieved in this review.
• Official Cursor Marketplace and Claude Directory: public approval was not reverified here. This does not change existing submissions or manual MCP installation support.

Surface truth: the catalogue contains 156 canonical operations. The local full profile serves 161 tool names, 11 resources, and 10 prompts (156 canonical operations plus 5 fiscal aliases). The hosted grouped profile serves 164 tool names, 7 resources, and 10 prompts (the same names plus 3 discovery tools, with API-backed resources kept local-only). The separately reviewed OpenAI profile serves 33 tool names, 0 resources, and 0 prompts. Catalogue membership is not a promise that a backing API is enabled for every workspace.

---

What is this

An MCP server that connects your AI assistant to Frihet. Create invoices by talking. Query expenses in natural language. Manage your entire business from your IDE.

You:     "Create an invoice for TechStart SL, 40 hours of consulting at 75 EUR/hour, due March 1st"
Claude:  Done. Invoice INV-2026-089 created. Total: 3,000.00 EUR + 21% IVA = 3,630.00 EUR.

156 canonical operations. Five fiscal aliases. Ten prompts. The local package serves 11 resources; the hosted Worker deliberately serves the 7 static resources, while API-backed workspace resources remain local-profile only.

---

Try it instantly (no signup)

Kick the tires with zero setup — no account, no API key:

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

In demo mode the server answers from realistic example fixtures (Spanish invoices with IVA/IGIC, expenses, clients, products, a bank account, and more) — every record uses demo_-prefixed IDs and the server prints a DEMO MODE banner on startup. Nothing is persisted and no network call is ever made. Writes are simulated and fiscal actions (e-invoice, VeriFactu, TicketBAI, FACe, payroll) return a clearly-labeled simulation — never a real submission to any tax authority.

When you're ready for your real data, drop the flag and add your key (app.frihet.io → Settings → API keys). See Install below.

---

For AI agents

If you are an agent reading this repository rather than a person reading a page, everything you need is machine-readable and generated from the running server — you do not have to parse this README.

What	Where
Onboarding contract: quickstart per client, auth, safe workflow, human-authority tool lists, error recovery	docs/agent-onboarding.json — also shipped inside the npm package
Per-tool capability truth: callability, writesFrihet, externalInteraction, externalSideEffects	_meta["io.frihet/capability"] on every entry of tools/list
How to behave once connected	the instructions string returned by initialize — your client hands it to you automatically

Three rules the contract encodes, in short:

1. Orient before acting. get_business_context and the frihet://tax/rates resource decide the correct fiscal treatment. Do not recall a Spanish tax rate from memory.
2. Draft, show, stop. create_invoice, create_quote and create_credit_note all default to status=draft — no fiscal number, no hash, nothing sent to a tax authority. Present the draft and hand back.
3. Human authority is not yours to assume. Any tool with a non-empty externalSideEffects reaches a client's inbox, a webhook, money, or AEAT / VeriFactu / TicketBAI / FACe. Several also take confirm=true; that flag records a human decision — never set it to satisfy your own plan.

docs/agent-onboarding.json is regenerated from the live surface by npm run generate:agent-onboarding and gated in CI by npm run gate:agent-onboarding, so its tool lists and counts cannot drift from the server.

---

Install

Local npm/stdio installs require Node 22.23.4+ (22.x), 24.22.1+ (24.x), or 26.12.1+ (26.x), covering the October 2026 Node security fixes. Node 20 is end-of-life: upgrade the Node runtime used by your MCP client before starting the server. CI uses Node 22.23.4.

This source change does not update previously published npm package metadata or users' installed Node runtimes. Updated package metadata requires a separate npm release; users can upgrade their runtime now. The remote Cloudflare Worker has a separate runtime and release process.

One-line (Claude Code, Cursor, Copilot, Codex, Windsurf, Gemini CLI, and more)

npx skills add Frihet-io/frihet-mcp

Claude Code plugin (skill + MCP server in one install)

This repository is also a Claude Code plugin (frihet-erp): installing it wires up both the business-management skill and the MCP server.

# Try it locally
claude --plugin-dir /path/to/frihet-mcp

Marketplace availability is pending. Use the local plugin command above or the Claude Code MCP command below to connect today.

Skill invocation: /frihet-erp:frihet-mcp. The bundled .mcp.json launches @frihet/mcp-server via npx — set FRIHET_API_KEY in your environment (get one at app.frihet.io → Settings → API keys).

The portable Claude plugin preview bundles real receivables, document-drafting and monthly-review skills with the existing public remote MCP. Load plugins/claude/frihet-erp in Claude Code or upload a ZIP of that folder in chat/Cowork. Its skills guide behavior; they do not filter the hosted catalogue or establish Directory approval. The root local MCP setup above keeps its existing API-key configuration.

Claude Code — one command

claude mcp add frihet -s user -e FRIHET_API_KEY=fri_your_key_here -- npx -y @frihet/mcp-server
claude mcp list          # verify: frihet ✓ Connected