FreelanceOS

by Sohlin2

373 downloads
Not rated
GitHub

About

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

Details

Author
Sohlin2
Downloads
373
Categories
Productivity, Project Management, Other, AI

- 37 MCP tools across 7 business entities
- 5 coaching skills teach Claude freelance best practices
- API key authentication with row-level security
- Hosted server with per-user isolated database
- Works offline for coaching skills without API key

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name FreelanceOS
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the plugin with claude plugin install freelance-os and paste your API key when prompted. After setup, you can manage clients, projects, proposals, invoices, time entries, scope definitions, and follow-ups by talking to Claude. An API key is required for data persistence; coaching skills work offline without one.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "freelanceos": {
            "freelance-os": {
                "url": "https://freelance-os-production.up.railway.app/mcp",
                "headers": {
                    "Authorization": "Bearer YOUR_API_KEY"
                }
            }
        }
    }
}

McpServers

{
    "freelance-os": {
        "url": "https://freelance-os-production.up.railway.app/mcp",
        "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
        }
    }
}

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

- Claude Code (CLI, desktop, or IDE extension)
- FreelanceOS API key (get one here)

License

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.