Frihet MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "FRIHET_API_KEY=${FRIHET_API_KEY}" frihet-mcp -- npx skills add Frihet-io/frihet-mcp
Required:FRIHET_API_KEY
README.md

AI-native MCP server for business management.

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

=18">


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.

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


Install

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

npx skills add Frihet-io/frihet-mcp

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

With OAuth 2.0 + PKCE (browser-based login, no API key needed):

Clients that support OAuth (Claude Desktop, Smithery, etc.) can connect directly to https://mcp.frihet.io/mcp and authenticate via browser. The server implements the full OAuth 2.1 authorization code flow with PKCE.

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's only shown once

What you can do

Talk to your ERP. These are real prompts, not marketing copy.

Invoicing

"Show me all unpaid invoices"
"Create an invoice for Acme SL with 10h of consulting at 95/hour"
"Mark invoice abc123 as paid"
"How much has ClientName been invoiced this year?"

Expenses

"Log a 59.99 EUR expense for Adobe Creative Cloud, category: software, tax-deductible"
"List all expenses from January"
"What did I spend on travel last quarter?"

Clients

"Add a new client: TechStart SL, NIF B12345678, email admin@techstart.es"
"Show me all my clients"
"Update ClientName's address to Calle Mayor 1, Madrid 28001"

CRM

"Add a contact to Acme SL: Ana Garcia, CTO, ana@acme.es"
"Log a call with TechStart: discussed Q2 proposal, they're interested in upgrade"
"Add a note to ClientName: prefers invoices in English, payment NET 30"
"Show me all activities for Acme SL"

Quotes

"Create a quote for Design Studio: logo design (2000 EUR) + brand guidelines (3500 EUR)"
"Show me all pending quotes"

Webhooks

"Set up a webhook to n

Tools (5)

manage_invoicesCreate, list, and update business invoices.
manage_expensesLog and query business expenses.
manage_clientsAdd, update, and retrieve client information.
manage_crmLog activities, contacts, and notes for clients.
manage_quotesCreate and list business quotes.

Environment Variables

FRIHET_API_KEYrequiredAPI key generated from app.frihet.io settings

Configuration

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

Try it

Create an invoice for TechStart SL, 40 hours of consulting at 75 EUR/hour, due March 1st
Log a 59.99 EUR expense for Adobe Creative Cloud, category: software, tax-deductible
Add a new client: TechStart SL, NIF B12345678, email admin@techstart.es
What did I spend on travel last quarter?
Create a quote for Design Studio: logo design (2000 EUR) + brand guidelines (3500 EUR)

Frequently Asked Questions

What are the key features of Frihet MCP Server?

AI-native business management for invoices, expenses, and clients. 52 tools for comprehensive ERP and CRM operations. Supports natural language queries for business data. Zero boilerplate integration with IDEs like Cursor, Windsurf, and Claude. Supports both local execution and remote hosted endpoints.

What can I use Frihet MCP Server for?

Automating invoice generation during client project completion. Tracking business expenses in real-time via natural language input. Managing client contact information and activity logs within the IDE. Generating professional quotes for new business opportunities.

How do I install Frihet MCP Server?

Install Frihet MCP Server by running: npx skills add Frihet-io/frihet-mcp

What MCP clients work with Frihet MCP Server?

Frihet MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Frihet MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare