freelance-tools-mcp

Disclaimer: Estimates only — not financial, legal, or tax advice. Consult a qualified accountant or attorney. All outputs must be verified independently. See TERMS.md and PRIVACY.md.

MCP server (Model Context Protocol) for freelancers and self-employed professionals. Rate calculator, proposal generator, invoice template, time tracker, pipeline manager, contract checklist, and tax estimator.

Pro Products

| Product | Price | Description | |---------|-------|-------------| | MCP Creator Kit | $29 | Everything to create your own MCP server -- template, CLI, docs, examples | | SceneView Pro Starter Kit | $49 | Complete Android 3D + AR app template -- 4 screens, ready to customize | | SceneView MCP Pro | $9.99/mo | Premium MCP tools and priority support |

Sponsor on GitHub -- Help us build the future of AI-powered developer tools

Installation

npm install -g freelance-tools-mcp

Or in your Claude Desktop / MCP configuration:

{
  "mcpServers": {
    "freelance-tools": {
      "command": "npx",
      "args": ["-y", "freelance-tools-mcp"]
    }
  }
}

Tools

calculate_rate

Calculate freelance hourly, daily, and project rates from income goals. Accounts for taxes, expenses, billable percentage, and compares to market rates.

Parameters: desired annual income, working days per year, billable percentage, annual expenses, tax rate.

generate_proposal

Generate a complete freelance project proposal in Markdown. Includes overview, scope, timeline, milestones, pricing, payment schedule, and terms.

Parameters: client name, project description, deliverables (array), timeline in weeks, weekly rate, payment terms.

create_invoice_template

Create a professional invoice in Markdown with line items, tax calculation, totals, and payment details. Supports multiple currencies (USD, EUR, GBP, and more).

Parameters: freelancer name, client name, items (array with description, quantity, rate), tax rate, currency, payment terms days, bank details.

summarize_time

Summarize time tracking entries by project. Calculates total billable hours, utilization rate, daily breakdown, and revenue estimates at multiple rates.

Parameters: entries (array with date, project, hours, description), period (week/month).

manage_pipeline

Analyze a freelance client pipeline. Provides weighted revenue forecast, stage breakdown, follow-up reminders, conversion rates, and pipeline health indicators.

Parameters: leads (array with name, value, stage prospect/proposal/negotiation/won/lost, last contact date).

check_contract

Audit a freelance contract for essential clauses. Checks for critical, important, and recommended clauses based on contract type (fixed price, hourly, retainer). Provides risk assessment and suggestions.

Parameters: contract type (fixed_price/hourly/retainer), clauses present (array of strings).

estimate_taxes

Estimate taxes and social contributions for self-employed freelancers. Supports France (FR), United States (US), United Kingdom (UK), and Germany (DE). Calculates income tax, social contributions, net income, quarterly payments, and deduction suggestions.

Parameters: annual revenue, annual expenses, country (FR/US/UK/DE), status (sole_proprietor/llc/ltd).

Usage Examples

With Claude

"What hourly rate should I charge if I want to earn $120k/year, work 220 days, bill 70% of my time, have $15k in expenses, and pay 30% tax?"

"Generate a proposal for Acme Corp for a 6-week React app project at $4,000/week."

"Create an invoice for 40 hours of development at $125/hr plus 10 hours of design at $100/hr, with 20% VAT, in EUR."

"Summarize my time entries for this week across Project Alpha and Project Beta."

"Analyze my sales pipeline: 3 prospects, 2 proposals out, 1 in negotiation, and 2 won deals."

"Check my fixed-price contract — it has scope, payment terms, and timeline but I'm not sure what else I need."

"Estimate my taxes as a sole proprietor in France with 80k revenue and 15k expenses."

With MCP CLI

npx freelance-tools-mcp

Development

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Run in development mode
npm run dev

License

Apache-2.0