freelancer-ops-mcp

Turn Claude into your freelance business manager — invoices, proposals, contracts, and financial dashboards, all via natural conversation.

Built for freelancers, consultants, and small agencies who want to run their business through AI without switching between 5 different apps.

npx -y freelancer-ops-mcp

What it does

Ask Claude to:

• "Create an invoice for Acme Corp — 10 hours of consulting at $150/hr, due in 30 days"
• "Generate a PDF proposal for the website redesign project"
• "Show me my outstanding balance"
• "What's my estimated tax for Q2?"
• "Which clients owe me money?"

Claude handles it. Your data lives locally in ~/.freelancer-ops/.

13 Tools

Invoices

| Tool | Description | |------|-------------| | create_invoice | Create invoice with line items, tax, and due date | | list_invoices | List and filter invoices by client, status, or date | | mark_paid | Mark an invoice as paid | | invoice_to_pdf | Generate a professional PDF invoice | | invoice_summary | Revenue totals for a month, year, or all time |

Proposals

| Tool | Description | |------|-------------| | create_proposal | Create proposal with scope, deliverables, timeline, and pricing | | list_proposals | List and filter proposals | | proposal_to_pdf | Generate a professional PDF proposal |

Contracts

| Tool | Description | |------|-------------| | create_contract | Create a service agreement with standard legal clauses | | contract_to_pdf | Generate a professional PDF contract |

Financial Dashboard

| Tool | Description | |------|-------------| | revenue_dashboard | Monthly revenue breakdown and top clients | | outstanding_balance | All unpaid invoices with overdue flags | | tax_estimate | SE tax + income tax estimate with quarterly payment |

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "freelancer-ops": {
      "command": "npx",
      "args": ["-y", "freelancer-ops-mcp"]
    }
  }
}

Cursor / Windsurf

Add to your MCP config:

{
  "mcpServers": {
    "freelancer-ops": {
      "command": "npx",
      "args": ["-y", "freelancer-ops-mcp"]
    }
  }
}

Personalize with your business info

Create ~/.freelancer-ops/config.json:

{
  "business_name": "Jane Smith Consulting",
  "email": "[email protected]",
  "address": "123 Main St, Austin TX 78701",
  "phone": "+1 (512) 555-0100",
  "website": "janesmith.dev"
}

Your name, email, and address will appear on all generated PDFs.

Pricing

| Tier | Price | Limit | |------|-------|-------| | Free | $0 | 5 document-creation actions/month | | Pro | Coming soon | Unlimited |

Free tier includes: All read/analytics tools are always free (list, dashboard, summary, tax estimate). The 5-action limit applies only to document creation (create_invoice, create_proposal, create_contract, and PDF generation).

Upgrade: Set FREELANCER_OPS_KEY environment variable in your MCP config:

{
  "mcpServers": {
    "freelancer-ops": {
      "command": "npx",
      "args": ["-y", "freelancer-ops-mcp"],
      "env": {
        "FREELANCER_OPS_KEY": "your-key-here"
      }
    }
  }
}

Get your key at https://freelancer-ops-mcp.dev/pricing

Data

All data is stored locally in SQLite at ~/.freelancer-ops/data.db. PDFs are saved to ~/.freelancer-ops/pdfs/. Nothing is sent to any server.

License

MIT