FreelanceOS MCP Server: Install & Setup

Install FreelanceOS in Claude Code

Remote URL

Claude Code

claude mcp add --transport http freelanceos https://freelance-os-production.up.railway.app/mcp

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "freelanceos": {
      "url": "https://freelance-os-production.up.railway.app/mcp"
    }
  }
}

npm

Claude Code

claude mcp add freelanceos -e FREELANCEOS_API_KEY=... -- npx -y freelance-os

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "freelanceos": {
      "command": "npx",
      "args": [
        "-y",
        "freelance-os"
      ],
      "env": {
        "FREELANCEOS_API_KEY": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the FreelanceOS MCP server do?

Freelance business manager — clients, proposals, invoices, time tracking, scope, and follow-ups.

Is the FreelanceOS MCP server free?

The server is free, but you will likely need an account. The server itself is free, but it connects to a service that needs an account or API key, which may have paid tiers. Check the provider for current pricing.

Does FreelanceOS run locally or remotely?

Local + Remote. Can run locally or be used as a hosted remote server.

How do I add FreelanceOS to Claude Code?

Run: claude mcp add --transport http freelanceos https://freelance-os-production.up.railway.app/mcp

More finance, fintech & payments MCP servers

View all

Freelancer Payment Protection

RudrenduPaul/freelancer-payment-protection

Wraps the fpp CLI as a single generic MCP tool for freelancer client payment-risk checks.

LocalFree

Formhaus

ignsm/formhaus

Validate Formhaus form definitions and simulate multi-step paths against the real engine.

LocalFree

Freematica

nubiia-dev/mcp-freematica

Freemática ERP: invoicing, receivables, suppliers, accounting and HR through 300+ MCP tools

LocalAccount needed

Flowcheck

eliaskress/flowcheck-mcp-server

Stripe payouts, Shopify orders, and bank transactions unified for reconciliation and cash flow

LocalAccount needed

Furlpay CLI

FurlPay/furlpay-cli

Stablecoin payments, swaps, stock orders, market data, travel booking, yield and card controls.

LocalFree

Flipzi

flipzitcg/flipzi-mcp

Trading card prices, sold comps, history and movers from the Flipzi Data API. Bring your own key.

LocalAccount needed