Frihet ERP

[frihet-mcp]

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

[npm version] [npm downloads] [MCP Registry] [156 canonical catalogue operations] [license]

[Frihet MCP — talk to your ERP in natural language]

What is this

An MCP server that connects your AI assistant to Frihet, the AI-native ERP for businesses of any size. Ask for invoices, expenses, clients, quotes, banking and tax figures in plain language, from the tools you already use.

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.

Quick start

Remote, one step. Add https://mcp.frihet.io/mcp as a remote MCP server in any client that supports OAuth. You sign in with your browser; there is nothing to install and no key to copy.

Local, with your API key (create one in app.frihet.io under Settings > API):

claude mcp add frihet -s user -e FRIHET_API_KEY=fri_your_key_here -- npx -y @frihet/mcp-server

No account yet? Try demo mode. It answers from example data, persists nothing and makes no network calls:

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

Local installs need Node 22.23.4+, 24.22.1+ or 26.12.1+. Other clients are covered under Client setup.

Distribution

Where to get it

Also listed on Glama, Cursor Directory, mcp.so, mcpservers.org and the ToolSDK registry.

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. These counts describe the current source release; the hosted server reports the version it is running at /health. Catalogue membership is not a promise that a backing API is enabled for every workspace.

What you can do

Real prompts, grouped by area.

Beyond these, the catalogue covers banking, e-invoicing, time tracking, recurring invoices, HR and payroll, POS and more. See the full catalogue.

Client setup

Claude Code

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

Or use the hosted server: claude mcp add --transport http frihet https://mcp.frihet.io/mcp.

Codex CLI

codex mcp add frihet --env FRIHET_API_KEY=fri_your_key_here -- npx -y @frihet/mcp-server

Codex reads TOML, not JSON. Pasting a JSON mcpServers block into ~/.codex/config.toml is a parse error that breaks the whole file, so use the command above.

Claude Desktop, Cursor, Windsurf, Cline

{  "mcpServers": {    "frihet": {      "command": "npx",      "args": ["-y", "@frihet/mcp-server"],      "env": {        "FRIHET_API_KEY": "fri_your_key_here"      }    }  }}

Remote server with an API key

{  "mcpServers": {    "frihet": {      "type": "streamable-http",      "url": "https://mcp.frihet.io/mcp",      "headers": {        "Authorization": "Bearer fri_your_key_here"      }    }  }}

Clients that support OAuth 2.1 with PKCE can connect to the same URL and sign in through the browser instead.

ChatGPT

Open Frihet in ChatGPT and connect your account.

Skill for coding agents

npx skills add Frihet-io/frihet-mcp

Installs the Frihet skill for Claude Code, Cursor, Codex, Windsurf, Gemini CLI and others. It routes requests to the MCP tools and asks for confirmation before writes. Tax figures come from your Frihet data, not from the skill. Skill docs.

Get your API key

1. Log into app.frihet.io
2. Go to Settings > API
3. Click Create API key
4. Copy the key (starts with fri_). It is only shown once.

For AI agents

If you are an agent reading this repository, the contract is machine-readable and generated from the running server.

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

What to expect

This MCP is a structured data interface -- you describe what you want in natural language, and the AI creates, queries, or modifies business records in Frihet. Most of the 156 canonical operations are CRUD operations over the REST API; the rest are read-only summaries and fiscal/e-invoice actions. Alias and discovery names are counted separately.

It does not do OCR, PDF scanning, file upload or image processing. To digitize a paper invoice, extract the data first (a vision model, an OCR service, or manual entry), then ask the assistant to create the record. One API key maps to one Frihet workspace, and you need a Frihet account at app.frihet.io.

Full catalogue

Configuration

FRIHET_TOOL_MODE=grouped is progressive disclosure: each tool description collapses to one line and three discovery tools (list_tool_groups, search_tools, describe_tool) are added, so an agent loads full schemas only for the tools it needs. Operation names, input schemas and handlers do not change. The hosted server runs in grouped mode.

{  "mcpServers": {    "frihet": {      "command": "npx",      "args": ["@frihet/mcp-server"],      "env": { "FRIHET_API_KEY": "fri_...", "FRIHET_TOOL_MODE": "grouped" }    }  }}

Rate limits depend on your plan; the server retries with exponential backoff on 429. See the API reference.

Development and contributing

git clone https://github.com/Frihet-io/frihet-mcp.gitcd frihet-mcpnpm installnpm run build   # must pass before submittingFRIHET_API_KEY=fri_xxx node dist/index.js

Test with the MCP Inspector: npx @modelcontextprotocol/inspector node dist/index.js. Open an issue before large changes. Report vulnerabilities as described in SECURITY.md.

Ecosystem

Frihet · Documentation · MCP server docs · OpenAPI spec

License

MIT. See LICENSE.

Built by Frihet.