Freelancer MCP Server

Name: Freelancer MCP Server
Author: godesigntech

by godesigntechversion 2.0.0i★ –iRuns on your computer

Registry nameio.github.godesigntech/freelancer-mcp-server

Install

Overview

Description from the maker (original English)

Search, bid, and message clients on Freelancer.com from Claude. Multi-account support.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Search & AI memory
You need to fill in: FREELANCER_OAUTH_TOKEN, FREELANCER_ACCOUNTS

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: FREELANCER_OAUTH_TOKEN, FREELANCER_ACCOUNTS

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "freelancer": {
      "command": "npx",
      "args": [
        "-y",
        "freelancer-mcp-server"
      ],
      "env": {
        "FREELANCER_OAUTH_TOKEN": "your-value",
        "FREELANCER_ACCOUNTS": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add freelancer --env FREELANCER_OAUTH_TOKEN=your-value --env FREELANCER_ACCOUNTS=your-value -- npx -y freelancer-mcp-server

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "freelancer": {
      "command": "npx",
      "args": [
        "-y",
        "freelancer-mcp-server"
      ],
      "env": {
        "FREELANCER_OAUTH_TOKEN": "your-value",
        "FREELANCER_ACCOUNTS": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "freelancer": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "freelancer-mcp-server"
      ],
      "env": {
        "FREELANCER_OAUTH_TOKEN": "your-value",
        "FREELANCER_ACCOUNTS": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

FREELANCER_OAUTH_TOKEN secret env
Personal Access Token for a single Freelancer.com account. Get one at https://accounts.freelancer.com/settings/develop
FREELANCER_ACCOUNTS secret env
JSON object mapping account labels to Personal Access Tokens, for connecting multiple Freelancer.com accounts in one server, e.g. {"main":"token1","client_acme":"token2"}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account godesigntech, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Search & AI memoryi

More stars than 0% of the other 7246 servers in this category
Published to the registry more recently than 20% of the other 7246 servers in this category
Basic checks equal to or better than 100% of the other 7246 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Freelancer MCP Server safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: FREELANCER_OAUTH_TOKEN, FREELANCER_ACCOUNTS

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (2.0.0) reached the registry 4 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Context7, Codebase Memory, Exa

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Context7

by upstash

Feeds AI the latest docs for libraries and frameworks before it answers, so code it writes does not use outdated, removed functions.

Computer or cloud★ 64,224MITUpdated today

Install

Codebase Memory

by DeusData

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

Runs on your computer★ 48,148MITUpdated 20 days ago

Install

Exa

by exa-labs

Connect AI agents to Exa for web search, content fetching, and multi-step research.

Runs in the cloud★ 5,213MITUpdated last month

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Freelancer MCP Server

An MCP server that connects Claude (Desktop, Code, or any MCP-compatible client) directly to Freelancer.com. Search and bid on projects, read and reply to client messages, review your track record, and manage skills/specialty profiles — all from a chat.

Supports multiple Freelancer accounts in one server (e.g. your own account plus one or more clients' accounts you manage), switchable per tool call.

This project is 100% self-contained: it talks only to freelancer.com's public API using whatever access token(s) you provide. No other data source, project, or third-party service is involved.

Get your access token (do this first)

Log in to Freelancer.com
Go to [accounts.freelancer.com/settings/develop](https://accounts.freelancer.com/settings/develop)
Under Application Dashboard, click Generate Token
Copy the token shown under Access Token

That token is all this server needs — no password, no app review, no OAuth redirect flow. Repeat this for each additional Freelancer account you want connected (see Multiple accounts).

What you can ask Claude

Tool	Example prompt
`freelancer_list_accounts`	"Which Freelancer accounts are connected?"
`freelancer_get_self`	"Show my profile and reputation"
`freelancer_get_user`	"Look up @some_freelancer on Freelancer"
`freelancer_search_projects`	"Find the latest n8n automation projects under $500"
`freelancer_get_project`	"Get details on project 12345678"
`freelancer_my_projects`	"List my active projects" / "Show my completed projects"
`freelancer_get_project_bids`	"Who has bid on project 12345 and how much?"
`freelancer_my_bids`	"Show my awarded bids" / "Show my rejected bids"
`freelancer_place_bid`	"Bid $200 on project 12345 with 5-day delivery"
`freelancer_get_milestones`	"What milestones are on project 12345?"
`freelancer_list_threads`	"Show my inbox"
`freelancer_get_messages`	"Read this chat: freelancer.com/messages/thread/98765"
`freelancer_send_message`	"Reply to thread 98765 saying..."
`freelancer_search_skills` / `list_skills` / `add_skills` / `remove_skills` / `set_skills`	"Add n8n and Zapier to my skills"
`freelancer_list_profiles` / `create_profile` / `update_profile`	"Create a specialty profile for AI automation"

Every tool accepts an optional account argument to pick which connected Freelancer account it should act on/as (see Multiple accounts).

Analyzing past projects & winning strategy

There's no single "analyze my strategy" button — instead, Claude does the analysis itself over the raw data this server exposes. This keeps the server a thin, honest API wrapper instead of a black box. Ask things like:

"Pull my awarded bids and my rejected bids, then compare amount, delivery time, and proposal length/style to figure out what's working."

"Look at my completed projects and tell me which skills show up most often."

"Compare my bid on project X to the other bids on it — am I priced competitively?"

Claude will chain freelancer_my_bids (status awarded vs rejected), freelancer_my_projects (status complete), and freelancer_get_project_bids to gather the data, then reason over it directly in the conversation.

Chat links and thread IDs

freelancer_get_messages and freelancer_send_message accept either a plain numeric thread ID or a pasted Freelancer chat/message link — the server extracts the ID either way.

See it in action

Finding and scoring the best projects to bid on, with a ready pitch script for each:

Reading a client thread by chat link and building a conversion strategy:

Auditing skills already on a profile:

Setup

The package is published on npm as freelancer-mcp-server — no clone, no build, npx fetches and runs it on demand.

Claude Code (CLI)

claude mcp add freelancer --env FREELANCER_OAUTH_TOKEN=your_token_here -- npx -y freelancer-mcp-server

Or just ask Claude Code directly, in plain English, once you have your token:

"Add the freelancer-mcp-server MCP server using npx, with my Freelancer access token set as FREELANCER_OAUTH_TOKEN"

Claude Code can run the claude mcp add command itself — you don't have to type it.

Claude Desktop

Open your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this block inside "mcpServers" (create the file if it doesn't exist):

"mcpServers": { "freelancer": { "command": "npx", "args": ["-y", "freelancer-mcp-server"], "env": { "FREELANCER_OAUTH_TOKEN": "your_token_here" } } } }

Restart Claude Desktop — you should see a 🔌 indicating the server connected.

Multiple accounts

To connect more than one Freelancer account (your own plus, say, two clients'), use FREELANCER_ACCOUNTS instead of FREELANCER_OAUTH_TOKEN — a JSON object mapping a label you choose to each token:

"mcpServers": { "freelancer": { "command": "npx", "args": ["-y", "freelancer-mcp-server"], "env": { "FREELANCER_ACCOUNTS": "{\"main\":\"token1\",\"client_acme\":\"token2\"}" } } } }

Or via claude mcp add:

claude mcp add freelancer --env FREELANCER_ACCOUNTS='{"main":"token1","client_acme":"token2"}' -- npx -y freelancer-mcp-server

The first account listed becomes the default (used when a tool call omits account). Ask Claude "which Freelancer accounts are connected?" to confirm, then say e.g. "using the client_acme account, show me the latest projects" to target a specific one. Tokens are never logged, echoed back, or written anywhere by this server — they only ever go into the outgoing freelancer-oauth-v1 header.

Running from source (contributing)

git clone https://github.com/godesigntech/freelancer-mcp-server.git

cd freelancer-mcp-server npm install npm run build claude mcp add freelancer --env FREELANCER_OAUTH_TOKEN=your_token_here -- node /FULL/PATH/TO/freelancer-mcp-server/dist/index.js

Testing

Ask Claude:

"Show my Freelancer profile"

If it responds with your username and stats, you're set.

Profile editing — what the Freelancer API actually allows

The Freelancer.com public REST API is read-mostly for profiles. After probing the live API, here's the real boundary:

Editable:

✅ Skills/jobs — add, remove, or replace the skills on an account (/users/0.1/self/jobs). Freelancer caps the total number of skills per account.
✅ Specialty profiles — create/update focused sub-profiles (/users/0.1/profiles): tagline, hourly_rate, description, skills. Caveats: the API has no endpoint to list your own profile IDs (you must already know them), and some account types (e.g. certain corporate accounts) cannot create new ones.

NOT possible via the public API (web-UI only):

❌ Main account bio/tagline/hourly rate shown on your public page
❌ Profile photo / avatar
❌ Experience, education, publications, references, certifications
❌ Portfolio (read-only via API)

Security notes

Tokens live only in your local MCP client config (or .env for npm run dev) — never committed, never sent anywhere but Freelancer's own API.
The server runs entirely on your machine; no telemetry, no third-party calls.
Destructive/real-world actions (place_bid, send_message, skill/profile edits) always surface for your review before they execute, since Claude shows tool calls before running them.
This repo contains no data from, and no dependency on, any other project — it's a clean, standalone Freelancer.com integration.

Troubleshooting

"no Freelancer accounts configured" → Set FREELANCER_OAUTH_TOKEN or FREELANCER_ACCOUNTS in your MCP client config.

401 Unauthorized → Token expired or wrong. Generate a fresh one at https://accounts.freelancer.com/settings/develop

"Unknown account "x"" → Run freelancer_list_accounts to see the exact labels configured, then use one of those.

Tool not appearing in Claude → If using npx, confirm Node.js 18+ is installed and npx -y freelancer-mcp-server runs without error from a terminal. If running from source, confirm the path in your config is the absolute path to dist/index.js, and that npm run build succeeded.

Contributing

Issues and PRs welcome. Keep changes scoped to the Freelancer.com API surface — this project intentionally stays a single-purpose, dependency-light MCP server.

License

MIT

Freelancer MCP Server

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Search & AI memoryi

Common questions

Alternatives

Context7

Codebase Memory

Exa

README from the maker

Freelancer MCP Server

Get your access token (do this first)

What you can ask Claude

Analyzing past projects & winning strategy

Chat links and thread IDs

See it in action

Setup

Claude Code (CLI)

Claude Desktop

Multiple accounts

Running from source (contributing)

Testing

Profile editing — what the Freelancer API actually allows

Security notes

Troubleshooting

Contributing

License