Frihet
AI-native business management MCP server — 31 tools for invoicing, expenses, clients, products, quotes & tax compliance. 40 currencies, OCR, Stripe Connect. MIT licensed.
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.
31 tools. 5 resources. 5 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
- Log into app.frihet.io
- Go to Settings > API
- Click Create API key
- 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 [email protected]"
"Show me all my clients"
"Update ClientName's address to Calle Mayor 1, Madrid 28001"
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 notify https://my-app.com/hook when invoices are paid"
"List all my active webhooks"
Tools (31)
Invoices (6)
| Tool | What it does |
|---|---|
list_invoices | List invoices with pagination |
get_invoice | Get full invoice details by ID |
create_invoice | Create a new invoice with line items |
update_invoice | Update any invoice field |
delete_invoice | Permanently delete an invoice |
search_invoices | Find invoices by client name |
Expenses (5)
| Tool | What it does |
|---|---|
list_expenses | List expenses with pagination |
get_expense | Get expense details |
create_expense | Record a new expense |
update_expense | Modify an expense |
delete_expense | Delete an expense |
Clients (5)
| Tool | What it does |
|---|---|
list_clients | List all clients |
get_client | Get client details |
create_client | Register a new client |
update_client | Update client info |
delete_client | Remove a client |
Products (5)
| Tool | What it does |
|---|---|
list_products | List products and services |
get_product | Get product details |
create_product | Add a product or service |
update_product | Update pricing or details |
delete_product | Remove a product |
Quotes (5)
| Tool | What it does |
|---|---|
list_quotes | List all quotes |
get_quote | Get quote details |
create_quote | Draft a new quote |
update_quote | Modify a quote |
delete_quote | Delete a quote |
Webhooks (5)
| Tool | What it does |
|---|---|
list_webhooks | List configured webhooks |
get_webhook | Get webhook details |
create_webhook | Register a new webhook endpoint |
update_webhook | Modify events or URL |
delete_webhook | Remove a webhook |
All 31 tools return structured output via outputSchema -- typed JSON, not raw text. List tools return paginated results ({ data, total, limit, offset }).
Resources (5)
Static context the AI can read without making API calls.
| Resource | URI | What it provides |
|---|---|---|
| API Schema | frihet://api/schema | OpenAPI summary: endpoints, auth, rate limits, pagination, error codes |
| Tax Rates | frihet://tax/rates | Tax rates by Spanish fiscal zone: IVA, IGIC, IPSI, EU reverse charge, IRPF |
| Tax Calendar | frihet://tax/calendar | Quarterly filing deadlines: Modelo 303, 130, 390, 420, VeriFactu timeline |
| Expense Categories | frihet://config/expense-categories | 8 categories with deductibility rules, IVA treatment, amortization |
| Invoice Statuses | frihet://config/invoice-statuses | Status flow (draft > sent > paid/overdue > cancelled), transition rules, webhook events |
Prompts (5)
Pre-built workflows the AI can execute as guided multi-step operations.
| Prompt | What it does | Arguments |
|---|---|---|
monthly-close | Close the month: review unpaid invoices, categorize expenses, check tax obligations, generate summary | month? (YYYY-MM) |
onboard-client | Set up a new client with correct tax rates by location, optionally create a welcome quote | clientName, country?, region? |
quarterly-tax-prep | Prepare quarterly tax filing: calculate IVA/IGIC, identify deductibles, preview Modelo 303/130/420 | quarter?, fiscalZone? |
overdue-followup | Find overdue invoices, draft follow-up messages, suggest payment reminders | -- |
expense-batch | Process expenses in bulk: categorize, apply tax rates, flag missing receipts | fiscalZone? |
How it works
Your AI assistant frihet-mcp Frihet API
| | |
|-- "create invoice" --> | |
| |-- POST /invoices ->|
| |<-- 201 Created ----|
|<-- structured JSON --- | |
The server translates tool calls into REST API requests. It handles authentication, rate limiting (automatic retry with backoff on 429), pagination, and error mapping.
Two transports:
- stdio (local) --
npx @frihet/mcp-serverwithFRIHET_API_KEY - Streamable HTTP (remote) --
https://mcp.frihet.io/mcpwith Bearer token or OAuth 2.0+PKCE
Environment variables
| Variable | Required | Default |
|---|---|---|
FRIHET_API_KEY | Yes (stdio) | -- |
FRIHET_API_URL | No | https://api.frihet.io/v1 |
API limits
| Limit | Value |
|---|---|
| Requests per minute | 100 per API key |
| Results per page | 100 max (50 default) |
| Request body | 1 MB max |
| Webhook payload | 100 KB max |
| Webhooks per account | 20 max |
Rate limiting is handled automatically with exponential backoff.
Claude Code Skill
Beyond raw MCP tools, this repo includes a Claude Code skill that adds business context: Spanish tax rules, workflow recipes, financial reports, and natural language commands.
Install the skill
git clone https://github.com/Frihet-io/frihet-mcp.git
ln -s "$(pwd)/frihet-mcp/skill" ~/.claude/skills/frihet
Or with the universal installer:
npx skills add Frihet-io/frihet-mcp
Commands
| Command | What it does |
|---|---|
/frihet status | Account overview, recent activity, pending payments |
/frihet invoice | Create, list, search invoices |
/frihet expense | Log and query expenses |
/frihet clients | Manage client database |
/frihet quote | Create and manage quotes |
/frihet report | Financial summaries (P&L, quarterly, overdue) |
/frihet webhooks | Configure automation triggers |
/frihet setup | Guided setup and connection test |
The skill knows about IVA rates, IRPF retention, Modelo 303 prep, expense deductibility rules, and VeriFactu compliance.
Full documentation: docs.frihet.io/desarrolladores/skill-claude-code
Development
git clone https://github.com/Frihet-io/frihet-mcp.git
cd frihet-mcp
npm install
npm run build
Run locally:
FRIHET_API_KEY=fri_xxx node dist/index.js
Test with the MCP Inspector:
npx @modelcontextprotocol/inspector node dist/index.js
Contributing
Contributions are welcome. Please open an issue first to discuss what you'd like to change.
git clone https://github.com/Frihet-io/frihet-mcp.git
cd frihet-mcp
npm install
npm run build # must pass before submitting
Links
- Frihet -- The product
- Documentation -- Full docs
- API reference -- REST API
- MCP server docs -- Setup guides, troubleshooting
- Webhook docs -- Events, signatures, retries
- npm -- Package registry
- MCP Registry -- Official MCP Registry
- Smithery -- Smithery marketplace
- Remote endpoint -- Hosted MCP server (Cloudflare Workers)
- OpenAPI spec -- Machine-readable API definition
- MCP specification -- The protocol
License
MIT. See LICENSE.
Built by Frihet.
Related Servers
Paprika 3
Manage your Paprika 3 recipes with an LLM. Read, create, and update recipes in your Paprika app.
Miro
Miro MCP server, exposing all functionalities available in official Miro SDK.
Foreman MCP Server
MCP server for Foreman host management and infrastructure automation.
eSignatures
Contract and template management for drafting, reviewing, and sending binding contracts.
Scrapbox/CoSense
A server for the Scrapbox/CoSense platform to retrieve, list, search, and create pages.
Mautic
Integrates with the Mautic marketing automation platform.
Intugle MCP
Generate automated semantic models using data engineering agents and built data products on demand
GoHighLevel MCP Server
Integrates with the GoHighLevel API, allowing interaction with its CRM, marketing automation, and business management tools.
Microsoft Office (PowerPoint & Excel)
Automate Microsoft PowerPoint and Excel on Windows using AI-powered COM automation.
MCP Client Configuration Server
Manages configurations for MCP clients, automatically detecting file paths based on OS and client.