Frihet ERP MCP Server

Official

AI-native MCP server for business management, invoicing, and fiscal compliance.

How to install ↓ Compare GitHub source repository ↗

Category: Other
Stars: ★ 12 Popular
Transport: stdio (local process) · Streamable HTTP
Runtime: Node.js 18+ · Hosted (no local runtime)
Credentials: API key / credential required
License: MIT
Last commit: 6 days ago
Tools: 100

47FMRS · D

This official MCP server offers deep integration with Frihet ERP, suitable for users needing comprehensive business management and European tax compliance. Considering the sensitivity of data, careful evaluation is recommended before use.

Strongest · Documentation 13/20 Weakest · Reliability 6/20

Reliability

6/20

Security and permissions

8/20

Maintenance

10/20

Documentation

13/20

Setup experience

10/20

Why each score

Reliability 6/20: Limited evidence: only README and manifest reviewed. Claimed 157 tools, 11 resources, 10 prompts, but no actual code verified. Manifest correctly declares stdio and streamable-http transports, but no executable tests or CI to confirm server starts cleanly and completes initialization handshake. Potential inconsistencies: mentions 'FRIHET_OPENAI_MODE' and 'grouped' mode but not fully detailed in README. Deductions: no test evidence, no code inspection; susceptibility to unverified claims of full maturity. Static calibration: reliability anchor caps at 12, but lack of evidence reduces.
Security and permissions 8/20: API key handling observed: FRIHET_API_KEY as env variable, examples use placeholder 'fri_your_key_here'. Dangerous operations require confirmation flags (e.g., delete_..._confirm=true, period_close, gestor/admin). Network usage exists: tools call REST API and send webhooks, but data flow is well-disclosed in 'How it works' diagram. Remote endpoint supports OAuth 2.0+PKCE. Demo mode makes no network calls and simulates writes. Main risks are mitigated, but permission scoping (tool_mode, grouped) may default to full exposure. Awarded lower due to lack of code audit, but high because of clear confirmation and rate-limiting disclosure.
Maintenance 10/20: Scored based on metadata: repo is active (not archived), MIT license present, version 1.18.0, 7 open issues. No evidence of release cadence or issue responsiveness. Security response channel documented? README does not mention. Dependencies not shown. Reduced due to absence of commit history without knowledge.
Documentation 13/20: README is very extensive: installation (local and remote), API key acquisition, per-tool listing, resources, prompts, and environment variables. Includes documentation of tool modes (full/grouped). Includes API limits (rate limiting). Includes troubleshooting? Not a dedicated section. Includes cost? Not mentioned, could lead to unexpected expenses. Deductions: API costs or detailed troubleshooting not included; source code would but method is independent. Demo mode provides mild evidence for claims. Awarded high for layered structure and covering many but not all aspects.
Setup experience 10/20: Clear installation steps: npm/npx, client config JSON (Claude Code, Cursor, etc.). Remote endpoint URL provided. Environment variables documented. Demo mode allows quick trial. Requires FRIHET_API_KEY. Supports both transports. Complexity: 157 tools could be heavy for clients, but grouped mode mitigates. Multiple config examples for applicable clients. Slight credit for no-signup trial but not extra evidence. Score below 15 because no execution evidence in repo.

Static review · not runListed 2026-09-08

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkChanges third-party account data

Best for

Spanish and EU-based businesses needing comprehensive ERP integration
Accountants who need to handle fiscal compliance (VeriFactu, TicketBAI, Facturae)
SMEs wanting to streamline operations with AI
For managing vertical operations like restaurants and hospitality

Not for

Users who need simple tasks without full ERP depth
Those needing OCR or PDF scanning (not supported)
Complex banking features beyond reconciliation (not mentioned)

Required permissions

Requires FRIHET_API_KEY environment variable
Grants access to all business data within that workspace via API
Supports authentication for remote endpoint (Bearer token or OAuth)

Risks and side effects

Sensitive financial data is sent to client AI services
Tools can modify and delete data; those marked 'TRUST AREA' are sensitive
Exposed API keys could lead to unauthorized access to business data
Write operations and fiscal submissions should be confirmed by the client

Setup

Before you start

Runtime：Node.js 18+ · Hosted (no local runtime)

FRIHET_API_KEY requiredsecret Frihet API key (starts with fri_), required for stdio mode; create it at app.frihet.io under Settings > API, shown only once.

Other optional settings (3)

FRIHET_API_URL optional Optional; overrides the REST API base URL, defaults to https://api.frihet.io/v1.

FRIHET_TOOL_MODE optional Optional; set to grouped for progressive tool disclosure via discovery meta-tools, default is full.

FRIHET_DEMO optional Optional; set to 1 to run in demo mode with fixture data, no network calls, and no persistence.

Sign up for a Frihet account at app.frihet.io and create an API key (starting with fri_).
Add the MCP server to your client's configuration file.
For Claude Code/Desktop, Cursor, Windsurf, and others, use the npm package @frihet/mcp-server via npx and set FRIHET_API_KEY env var.
Alternatively, use the remote endpoint: https://mcp.frihet.io/mcp (via Bearer token or OAuth 2.0 + PKCE authentication).
To try the demo without an account, set FRIHET_DEMO=1 environment variable.

claude_desktop_config.json

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

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

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

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

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

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

Start the server with npx -y @frihet/mcp-server and FRIHET_API_KEY set, then confirm tools like list_invoices and get_business_context appear in your client's tool list. You can also run FRIHET_DEMO=1 for a no-key smoke test — the server prints a DEMO MODE banner on startup.

Troubleshooting

If tools don't load, check network and API key format (fri_…)
Check that FRIHET_API_KEY environment variable is set correctly
For remote endpoint, ensure network access and authentication
Verify your MCP client version and configuration in the server

Things to try

Once connected, you can ask your AI assistant things like:

Show me all unpaid invoices over 1,000 EUR.
Create an invoice for TechStart SL: 40 hours of consulting at 75 EUR/hour.
Mark invoice INV-2026-089 as paid with today's payment date.
What's my monthly summary — revenue, expenses, and tax liability for this month?

Tools 100

list_invoices read-only

Lists invoices with pagination.

get_invoice read-only

Gets full invoice details by ID.

create_invoice writes

Creates a new invoice with line items.

update_invoice writes

delete_invoice destructive

search_invoices read-only

send_invoice destructive

mark_invoice_paid writes

Show 92 more tools

get_invoice_pdf read-only

get_invoice_einvoice read-only

create_credit_note writes

apply_late_fee writes

list_expenses read-only

get_expense read-only

create_expense writes

Records a new expense.

update_expense writes

delete_expense destructive

list_clients read-only

Lists all clients.

get_client read-only

create_client writes

Registers a new client.

update_client writes

delete_client destructive

list_client_contacts read-only

create_client_contact writes

delete_client_contact destructive

list_client_activities read-only

log_client_activity writes

list_client_notes read-only

create_client_note writes

delete_client_note destructive

list_products read-only

get_product read-only

create_product writes

update_product writes

delete_product destructive

list_quotes read-only

get_quote read-only

create_quote writes

update_quote writes

delete_quote destructive

send_quote destructive

list_webhooks read-only

get_webhook read-only

create_webhook writes

update_webhook writes

delete_webhook destructive

test_webhook writes

get_business_context read-only

get_monthly_summary read-only

get_quarterly_taxes read-only

duplicate_invoice writes

send_einvoice destructive

Dispatches e-invoice in 11 formats (XRechnung, Factur-X, FatturaPA, PEPPOL, Facturae, etc.).

get_einvoice_status read-only

validate_einvoice_xml read-only

export_datev read-only

einvoice_export read-only

face_submit destructive

face_status read-only

ticketbai_submit destructive

ticketbai_status read-only

ksef_submit destructive

list_time_entries read-only

get_time_entry read-only

create_time_entry writes

update_time_entry writes

delete_time_entry destructive

get_time_summary read-only

list_recurring_invoices read-only

get_recurring_invoice read-only

create_recurring_invoice writes

update_recurring_invoice writes

pause_recurring_invoice writes

resume_recurring_invoice writes

delete_recurring_invoice destructive

run_recurring_now writes

list_team_members read-only

invite_team_member writes

update_team_member_role writes

remove_team_member destructive

gestoria_message_send destructive

gestoria_messages_list read-only

gestoria_template_create writes

gestoria_template_bulk_send destructive

gestoria_aging_consolidated read-only

frihet_gl_entry_approve writes

frihet_gl_entry_reject writes

frihet_gl_entry_audit_log read-only

frihet_portal_domain_add writes

frihet_portal_domain_verify read-only

frihet_portal_domain_remove destructive

frihet_portal_onboard_link_generate writes

frihet_tax_id_vies_lookup read-only

frihet_modelo_415_summary read-only

frihet_modelo_425_summary read-only

frihet_modelo_418_summary read-only

frihet_aiem_calculate read-only

frihet_modelo_200_summary read-only

frihet_modelo_202_summary read-only

frihet_bank_rules_list read-only

frihet_bank_rule_create writes

Use cases

Create and manage invoices using natural language

Record and query expenses through chat

Manage clients, contacts, activities, and notes

Handle products, quotes, bank transactions, and vendors

Deal with Spanish and EU tax compliance (VeriFactu, TicketBAI, Facturae)

Manage team, HR, payroll, and period close

Supported clients

Claude Desktop

Claude Code

Cursor

Windsurf

Cline

Codex

GitHub Copilot

Gemini CLI

Listed from the project's documentation, not tested by this site.

Overview

Frihet ERP MCP Server (official) connects your AI assistant to the Frihet ERP system, offering 157 tools (+5 fiscal aliases), 11 resources, and 10 prompts for managing invoices, expenses, clients, CRM, products, quotes, banking, HR/payroll, POS, kitchen/restaurant, and vacation rentals via natural language. It provides native support for Spanish and EU fiscal compliance, including VeriFactu, TicketBAI, and Facturae/FACe. Runs over stdio or remote Streamable HTTP, compatible with any MCP client. Requires a Frihet account and API key.

Similar servers

DuckDuckGo Search MCP Server 74 · B

MCP server providing web search and content fetching via DuckDuckGo

★ 1.5k · Tools 2 Compare with this →

Basic Memory 72 · B

Your AI never forgets again.

★ 4.3k · Tools 21 Compare with this →

Telegram MCP Server 70 · B

Telegram MCP server powered by Telethon to let MCP clients read chats, manage groups, and send/modify messages, media, contacts, and settings.

★ 1.8k · Tools 76 Compare with this →

Hostinger API MCP Server 70 · B

Official MCP server for Hostinger API.

★ 163 · Tools 100 Compare with this →

Compare with other MCP servers

Source revision 9046fd9f8d6c Data synced 2026-10-19 Read the FMRS scoring method