Log inSubmit server
Freelancer MCP Server logo

Freelancer MCP Server

Connect Claude and other MCP clients to Freelancer.com for project search, bidding, messaging, skills, and profile management.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Freelancer MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "freelancer-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "freelancer-mcp-server"
      ],
      "env": {
        "FREELANCER_OAUTH_TOKEN": "YOUR_VALUE_HERE",
        "FREELANCER_ACCOUNTS": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

freelancer-mcp-server MCP server connects Claude or another MCP-compatible client to Freelancer.com's public API. It exposes tools for finding projects, placing bids, reading and sending messages, reviewing bids and projects, and editing skills or specialty profiles. Access tokens are supplied through environment variables, with optional support for multiple Freelancer accounts selected per tool call. Reach for it when you want to manage Freelancer work from an MCP-enabled chat interface without a separate intermediary service.

Use cases

  • Search Freelancer projects by topic and budget
  • Place bids with delivery estimates
  • Read and reply to client message threads
  • Compare awarded and rejected bids
  • Manage skills and specialty profiles

Key features

  • Freelancer.com project search and details
  • Bid placement and bid history
  • Client message thread access
  • Multi-account token configuration
  • Skills and specialty profile management
  • Project, milestone, and reputation data

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

9/9 checks healthy over the last 46d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 16d ago via OSV.dev · freelancer-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads160Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.

How Freelancer MCP Server works

What freelancer-mcp-server MCP server does

The freelancer-mcp-server MCP server connects an MCP client to Freelancer.com's public API. It lets an agent inspect account data, search available projects, review project bids, manage the account's own bids and projects, and work with client message threads. It also exposes operations for account skills and specialty profiles.

The integration is intended for freelancers or operators managing more than one Freelancer account. Each configured account can be selected on an individual tool call, so one server process can serve a primary account and additional client accounts.

How it works

The server runs locally and sends requests only to Freelancer.com using the access token or tokens supplied in its configuration. It does not use a separate database, third-party service, or external data source. The package can be started through npx, or built and run from a local checkout.

Most operations are read-oriented, while actions such as bidding, messaging, and changing skills or profiles modify remote account data. Message tools accept either a numeric thread ID or a pasted Freelancer chat link and extract the thread identifier when needed.

For analysis, the server provides raw account and project data rather than a dedicated strategy-scoring feature. An MCP client can combine awarded and rejected bids, completed projects, and competing bids, then reason over those results in the conversation.

Setup and configuration

First generate an access token from Freelancer.com's developer settings. For one account, set FREELANCER_OAUTH_TOKEN in the MCP client's environment and run npx -y freelancer-mcp-server. Claude Code can register the command with claude mcp add; Claude Desktop requires adding an mcpServers entry to its configuration file and restarting the application.

For multiple accounts, use FREELANCER_ACCOUNTS instead. Its value is a JSON object mapping labels to tokens, such as {"main":"token1","client_acme":"token2"}. The first listed account is the default when a tool call does not specify account. Use the account-listing tool to confirm the configured labels.

Node.js 18 or newer is required when troubleshooting an npx installation. Source-based setup requires cloning the repository, installing dependencies, building the project, and pointing the client at the resulting dist/index.js file.

Tools and capabilities

The freelancer-mcp-server MCP server includes tools for:

  • Listing connected accounts and retrieving the current account or another Freelancer user.
  • Searching projects, retrieving project details, listing personal projects, and inspecting project bids.
  • Listing personal bids by status, including awarded or rejected bids, and placing a bid with an amount and delivery time.
  • Listing message threads, reading messages, and sending replies.
  • Searching, adding, removing, replacing, and listing account skills.
  • Listing, creating, and updating specialty profiles.
  • Retrieving project milestones and account reputation information.

The profile API has a defined boundary. Skills and specialty profiles can be changed, but the public API does not provide editing for the main bio, main tagline, main hourly rate, avatar, experience, education, publications, references, certifications, or portfolio. The API also cannot list an account's own specialty-profile IDs, so an existing ID may be needed for some profile operations.

Limitations and notes

An expired or incorrect token produces an authorization failure. Account labels must match the keys configured in FREELANCER_ACCOUNTS.

The public API is read-mostly for profiles, and Freelancer may limit the number of skills on an account. Some account types may not be able to create specialty profiles. The server is specific to Freelancer.com and does not combine data from other projects or services. Tokens remain in the local MCP client configuration or development environment and are sent to Freelancer's API.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Freelancer MCP Server

freelancer-mcp-server is an MCP server that connects Claude and other MCP clients to Freelancer.com's public API. Its main tools search projects, place bids, inspect projects and bids, read or send messages, manage skills, and create or update specialty profiles. Multiple Freelancer accounts can be configured and selected per tool call.

Install it by configuring your MCP client to run `npx -y freelancer-mcp-server` and providing a Freelancer access token. Claude Code uses `claude mcp add`; Claude Desktop requires an `mcpServers` configuration entry. Node.js 18 or newer is needed for the npx setup.

Configure multiple accounts with the `FREELANCER_ACCOUNTS` environment variable as a JSON object mapping account labels to access tokens. The first entry is the default, and each tool call can provide an `account` label to select a different configured account.

It can edit account skills and specialty profiles, including specialty-profile descriptions, taglines, hourly rates, and skills. The public API does not support editing the main bio, avatar, portfolio, or several other profile sections, and some account types cannot create specialty profiles.

Yes, it works with Claude Code through the `claude mcp add` command. Provide either `FREELANCER_OAUTH_TOKEN` for one account or `FREELANCER_ACCOUNTS` for multiple accounts, followed by the npx command that starts the server.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewFreelancer MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/freelancer-mcp-server?style=directory)](https://allmcps.com/mcp/freelancer-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/freelancer-mcp-server"><img src="https://allmcps.com/api/badge/freelancer-mcp-server?style=directory" alt="Freelancer MCP Server on AllMCPs" /></a>