FreelanceOS MCP Server

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

Documentation

FreelanceOS

Run your entire freelance business from Claude Code. Proposals, invoices, time tracking, scope management, and follow-ups — handled through chat. 37 hosted tools, 5 coaching skills, one install command.

npm version smithery badge freelance-os MCP server freelance-os MCP server MIT skills

🌐 Live: https://freelance-os-production.up.railway.app


Install

claude plugin install freelance-os

When prompted, paste your API key. That's it — start managing your freelance business conversationally.

Get an API key

PlanPriceLink
Monthly$19/month (7-day free trial)Start Free Trial
Lifetime$40 one-timeBuy Once

Monthly plan includes a 7-day free trial — no charge until day 8. Your API key is delivered instantly on the success page after checkout.

Why this exists

I was tired of jumping between Stripe, Notion, a spreadsheet for hours, and a Word doc for proposals every time a client emailed. Every tool wanted me to switch context, log in, copy data between them — meanwhile I was already in Claude Code 8 hours a day shipping client work. So I made the admin layer live where the work does. Conversational. Hosted server stores the data, AI handles the chaos.

— Built by Jacob Sohlin. The 5 coaching skills are MIT and live in this repo. The MCP server is hosted (not open source) — your subscription pays for hosting, billing, support, and per-user data isolation.

What you get

37 hosted MCP tools

Full CRUD across the freelance lifecycle, served by the hosted backend:

EntityToolsWhat you can do
Clients5CRM — contacts, billing rates, notes
Projects5Track work per client with budgets and timelines
Proposals5Draft, price, send — client_id derived from project_id
Invoices4JSONB line items, tax, status tracking. invoice_number and totals auto-computed
Time6Log hours, aggregate per project, real date_range of entries
Scope6Define boundaries, log change requests, detect creep
Follow-ups6Context-aware reminders, sent-tracking

5 coaching skills (MIT, in this repo)

The local layer that teaches Claude freelance domain expertise. Free to inspect, fork, and learn from:

SkillWhat it does
ProposalsPricing strategy, scope clarity, revision limits, payment terms
InvoicesLine item structure, payment terms, overdue management
Follow-upsTiming, tone, and content for every follow-up scenario
ScopeScope definition, change requests, creep detection
TimeLogging practices, hour aggregation, time-to-invoice workflow

Example workflows

New client onboarding:

"I have a new client, Acme Corp. Contact is Jane at [email protected]. They need a website redesign, budget around $5k."

End-of-week invoicing:

"Show me uninvoiced time for the Acme project this week and generate an invoice."

Scope creep detection:

"Jane asked for a blog section — is that in scope for the Acme redesign?"

Follow-up on overdue invoice:

"Invoice INV-0042 is 2 weeks overdue. Draft a polite but firm follow-up to Jane."

Compatibility

ClientStatusNotes
Claude Code✅ First-classCoaching skills + MCP tools
Claude Desktop✅ Tools workAdd as a remote MCP server in claude_desktop_config.json
Cursor / Cline / Continue / etc.✅ Tools workAny MCP-compatible client connects to the Streamable HTTP endpoint

Issues & feedback

If something breaks, file an issue and I usually respond within a day.

License

MIT for the skills in this repo. The hosted MCP server is closed-source — your subscription pays for hosting, support, and per-user data isolation.

Jacob Sohlin