Frihet MCP

<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="./assets/banner.svg"> <source media="(prefers-color-scheme: light)" srcset="./assets/banner-light.svg"> <img alt="frihet-mcp" src="https://raw.githubusercontent.com/Frihet-io/frihet-mcp/main/assets/banner.svg" width="100%"/> </picture> </p> <p align="center"> <strong>AI-native MCP server for business management.</strong><br/> <em>Servidor MCP nativo con IA para gestión empresarial.</em> </p> <p align="center"> _{Works with <strong>Claude</strong> · <strong>ChatGPT</strong> · <strong>Cursor</strong> · <strong>Windsurf</strong> · <strong>Cline</strong> · <strong>Antigravity</strong> · <strong>Codex</strong> · <strong>Copilot</strong> · <strong>Gemini CLI</strong> — and any MCP-compatible client.} </p> <p align="center"> </p> <p align="center"> <img src="https://raw.githubusercontent.com/Frihet-io/frihet-mcp/main/assets/demo-tour.gif" alt="Frihet MCP — talk to your ERP in natural language" width="82%"> </p>

---

Distribution

Channel	Status	Install
npm	Live	npx @frihet/mcp-server
Remote endpoint	Live	https://mcp.frihet.io/mcp (zero install, OAuth or API key)
MCP Registry	Live	registry.modelcontextprotocol.io
Glama	Live	glama.ai/mcp/servers/Frihet-io/frihet-mcp
mcp.so	Auto-index (unverified)	mcp.so — indexes from npm + GitHub
PulseMCP	Auto-index (unverified)	pulsemcp.com — indexes from npm + GitHub
Cursor Marketplace	Coming soon	cursor.com/marketplace
ChatGPT Apps	Coming soon	chatgpt.com
Anthropic Claude Directory	Coming soon	claude.ai/settings/connectors

Tool count: npm latest (1.16.4) ships all 157 tools, same as the remote endpoint (mcp.frihet.io).

---

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.

157 tools. 11 resources. 10 prompts. Structured output on every tool. Zero boilerplate.

<!-- v1.12.0-beta.1 — D4-B megasprint: HR (9), payroll (2), onboarding (2), permissions (2), period close (3), webhook test (1) = +19 = 157 tools total -->

---

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.

---

Install

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

Once available in the community marketplace:

/plugin marketplace add anthropics/claude-plugins-community
/plugin install frihet-erp@claude-community

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

Claude Code / Claude Desktop

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

Tool	Config file
Claude Code	~/.claude/mcp.json
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json
Cursor	.cursor/mcp.json or ~/.cursor/mcp.json
Windsurf	~/.windsurf/mcp.json
Cline	VS Code settings or .cline/mcp.json
Codex CLI	~/.codex/config.toml (MCP section)

The JSON config is identical for all tools. Only the file path changes.

Remote (no install)

Use the hosted endpoint at mcp.frihet.io -- zero local dependencies, runs on Cloudflare Workers.

With API key:

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