FreelanceOS
AI-powered freelance business manager for Claude Code. Proposals, invoices, time tracking, scope management, and follow-ups - 37 tools, 5 coaching skills.
README
FreelanceOS
Manage your entire freelance business from Claude Code. Proposals, invoices, time tracking, scope management, and follow-ups — all conversational.
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
- Claude Code (CLI, desktop, or IDE extension)
- FreelanceOS API key (get one here)
License
MIT — skills are free, MCP server requires an API key.
Recommended Servers
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.
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.
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.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
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.
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.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
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.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.