FreelanceOS

FreelanceOS

AI-powered freelance business manager for Claude Code. Proposals, invoices, time tracking, scope management, and follow-ups - 37 tools, 5 coaching skills.

Category
Visit Server

README

FreelanceOS

Manage your entire freelance business from Claude Code. Proposals, invoices, time tracking, scope management, and follow-ups — all conversational.

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

Install

claude plugin install freelance-os

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

Get Your API Key

Plan Price Link
Monthly $19/month (7-day free trial) Start Free Trial
Lifetime $40 one-time Buy Once

Monthly plans include a 7-day free trial — no charge until day 8. Your API key is delivered instantly. Stored in your system keychain — never in plaintext.

What You Get

37 MCP Tools

Full CRUD across your entire freelance lifecycle:

Entity Tools What You Can Do
Clients create, list, get Full CRM — contacts, billing rates, notes
Projects create, list, get, update Track work per client with budgets and timelines
Proposals create, list, get, update Draft, price, send — auto-seeds scope on accept
Invoices create, list, get, update JSONB line items, tax, status tracking (draft/sent/paid/overdue)
Time create, list, aggregate Log hours, aggregate per project for invoicing
Scope create_definition, list_changes, log_change Define boundaries, detect scope creep
Follow-ups create, list, get, mark_sent Context-aware reminders and check-ins

5 Coaching Skills

Claude learns freelance best practices — not just data entry:

Skill What It Does
Proposals Pricing strategy, scope clarity, revision limits, payment terms
Invoices Line item structure, payment terms, overdue management
Follow-ups Timing, tone, and content for every follow-up scenario
Scope Scope definition, change requests, creep detection
Time Logging practices, hour aggregation, time-to-invoice workflow

How It Works

You (Claude Code) → "Draft a proposal for Acme Corp's website redesign at $150/hr"
                         ↓
Claude (with FreelanceOS skills) → Expert proposal with pricing, terms, scope
                         ↓
MCP Server → Saves to your secure, isolated database
  • 5 skill files teach Claude freelance domain expertise
  • Hosted MCP server persists all data with per-user isolation
  • API key auth — your data is yours, protected by row-level security
  • Works offline — coaching skills work without a key (data persistence requires one)

Example Workflows

New client onboarding:

"I have a new client, Acme Corp. Contact is Jane at jane@acme.com. They need a website redesign, budget around $5k."

End-of-week invoicing:

"Show me all 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-042 is 2 weeks overdue. Draft a polite but firm follow-up to Jane."

Requirements

License

MIT — skills are free, MCP server requires an API key.

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured