Log inSubmit server
MCP Server logo

MCP Server

by @frihet

Connects AI clients to Frihet for managing invoices, expenses, clients, products, quotes, and other business operations.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "frihet-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@frihet/mcp-server"
      ],
      "env": {
        "FRIHET_DEMO": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

@frihet/mcp-server connects MCP-compatible AI clients to Frihet, an AI-oriented business management platform. It exposes operations for invoices, expenses, clients, products, quotes, banking, payroll, fiscal workflows, and other ERP tasks. Run it locally through npm or connect to Frihet's hosted MCP endpoint using OAuth or an API key. Use demo mode to explore realistic fixture data without an account, persistence, or network requests.

Use cases

  • Create invoices from conversational instructions
  • Query expenses and business records
  • Manage clients, products, and quotes
  • Test MCP workflows with simulated fixtures
  • Run fiscal and payroll operations through an AI client

Key features

  • 156 canonical business operations
  • Invoice, expense, client, product, and quote management
  • HR, payroll, permissions, and period-close operations
  • Spanish fiscal workflow support
  • Local npm and hosted MCP deployment modes
  • Offline demo mode with simulated writes

Tools2

What MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~3 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

96/96 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · @frihet/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars13Stargazers on the source repository.
npm downloads1.3kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Tools exposed2Callable tools this server registers over MCP.
Directory activity12 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Server works

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:

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

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Server

@frihet/mcp-server is an MCP server that connects AI clients to Frihet's business-management platform. Its main tools cover invoices, expenses, clients, products, quotes, banking, payroll, HR, permissions, and fiscal workflows. It can run locally through npm, use demo fixtures, or connect to Frihet's hosted MCP endpoint.

Install it by launching `npx -y @frihet/mcp-server` from an MCP client's server configuration. For a no-account trial, prefix the command with `FRIHET_DEMO=1`. Real workspace access requires an API key obtained from Frihet's Settings area.

Yes, @frihet/mcp-server is listed as compatible with Cursor. Configure the local npm command in Cursor's MCP settings, or use the hosted MCP endpoint at `https://mcp.frihet.io/mcp` with the required authentication.

Yes, demo mode works without an account or API key. Run `FRIHET_DEMO=1 npx -y @frihet/mcp-server` to use realistic example fixtures. No network request is made, records are not persisted, and write or fiscal actions are simulated.

Yes, it can connect to `https://mcp.frihet.io/mcp`. The hosted route supports OAuth or an API key and provides a different profile from the local package, including static resources and grouped tools.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/-frihet-mcp-server?style=directory)](https://allmcps.com/mcp/-frihet-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/-frihet-mcp-server"><img src="https://allmcps.com/api/badge/-frihet-mcp-server?style=directory" alt="MCP Server on AllMCPs" /></a>