Freelancer MCP server

Read from the package source without running it. The installed server may list more.

• freelancer_add_skills

  Add one or more skills (jobs) to your Freelancer.com profile, keeping your existing skills. Args: - skills (string[]): Skill names (e.g. "n8n", "Python") or numeric skill IDs. Names are resolved via the catalogue. - account (string, optional): … Returns: confirmation. ⚠️ This modifies your real profile. Note: Freelancer enforces a maximum number of skills per account; adding past the limit will be

• freelancer_create_profilewrite action
• freelancer_get_messages

  Retrieve messages from a specific Freelancer.com thread. Args: - thread_id (string | number): Thread ID, or a Freelancer.com chat/message link containing one (get the ID from freelancer_list_threads if unknown) - limit (number, 1-50, default 20): Number of messages - offset (number, default 0): Pagination offset - account (string, optional): … Returns: messages with text, sender, timestamp and att

• freelancer_get_milestones

  List milestones for a specific Freelancer.com project. Args: - project_id (number): The project ID - account (string, optional): … Returns: list of milestones with amount, description, status and dates Milestone statuses include: created, requested, pending, released, cancelled Use when: "What are the milestones on project 12345?", "Has the milestone been released?", "Check payment status"

• freelancer_get_project

  Get full details of a specific Freelancer.com project by ID. Args: - project_id (number): The numeric project ID - account (string, optional): … Returns: full description, budget, status, skills, bid stats, timeline Use when: "Tell me more about project 12345678", "Get the details for this project"

• freelancer_get_project_bids

  List all bids on a specific Freelancer.com project. Args: - project_id (number): The project ID to fetch bids for - limit (number, 1-50, default 10): Number of bids to return - offset (number, default 0): Pagination offset - account (string, optional): … Returns: list of bids with amount, period, bidder reputation and description Use when: "Who has bid on project 12345?", "How much are people bidd

• freelancer_get_self

  Retrieve your own Freelancer.com profile, including reputation, earnings, skills, location and stats. Args: - account (string, optional): … Returns: - username, display name, tagline, location - reputation score and total reviews - registered skills/job categories - hourly rate and earnings - registration date Use when: "What's my profile?", "Show my reputation", "What are my stats on Freelancer?"

• freelancer_get_user

  Retrieve a Freelancer.com user profile by username or user ID. Args: - username (string, optional): Freelancer username (e.g. "usman_godesign") - user_id (number, optional): Numeric Freelancer user ID Provide at least one of username or user_id. - account (string, optional): … Returns: profile, reputation, skills, location, hourly rate Use when: "Look up this freelancer", "What's their rating?", "

• freelancer_list_accounts

  List the Freelancer.com account labels configured on this MCP server (never the tokens themselves). Use this to discover which `account` value to pass to other tools when multiple Freelancer profiles are connected (e.g. your own account plus one or more clients' accounts). Returns: account labels, and which one is the default (used when a tool call omits `account`). Use when: "Which Freelancer acc

• freelancer_list_profiles

  Fetch one or more of your Freelancer.com "specialty profiles" by their numeric profile IDs. Note: Freelancer's API has no endpoint that lists your profile IDs for you — you must already know the ID(s) (e.g. from the profile URL). This is a limitation of the public API, not this tool. Args: - profile_ids (number[]): Numeric specialty-profile IDs to fetch. - account (string, optional): … Returns: pr

• freelancer_list_skills

  List the skills (jobs) currently on your own Freelancer.com profile. Returns: your skills with numeric ID, name and category. Args: - account (string, optional): … Use when: "What skills are on my profile?", "List my skills", "Do I have n8n listed?"

• freelancer_list_threads

  List your Freelancer.com inbox message threads. Args: - context_type (string, optional): Filter by "project" or "freelancer_dashboard" - limit (number, 1-50, default 10): Number of threads - offset (number, default 0): Pagination offset - account (string, optional): … Returns: list of threads with members, last activity and message count Use when: "Show my inbox", "List my message threads", "Who h

• freelancer_my_bids

  List bids you have placed on Freelancer.com projects. Args: - status (string, optional): Filter by bid status — "active", "awarded", "revoked", "rejected" - limit (number, 1-50, default 10): Number of bids to return - offset (number, default 0): Pagination offset - account (string, optional): … Returns: your bids with project info, amounts and status. To analyze your winning strategy, call this tw

• freelancer_my_projects
• freelancer_place_bidwrite action

  Submit a bid / proposal on a Freelancer.com project. Args: - project_id (number): Project ID to bid on - amount (number): Your bid amount in the project's currency - period (number): Delivery time in days - description (string): Your proposal text (cover letter) - milestone_percentage (number, 0-100, default 100): Percentage to request as initial milestone - account (string, optional): … This is t

• freelancer_remove_skillswrite action

  Remove one or more skills (jobs) from your Freelancer.com profile. Args: - skills (string[]): Skill names or numeric IDs to remove. - account (string, optional): … Returns: confirmation. ⚠️ This modifies your real profile. Use when: "Remove PHP from my skills", "Drop skill 3 from my profile"

• freelancer_search_projects
• freelancer_search_skills

  Search the Freelancer.com skill (job) catalogue by name. Use this to find the numeric skill IDs needed by the skill-management tools. Args: - query (string): Substring to match against skill names (case-insensitive), e.g. "python", "n8n", "automation" - limit (number, default 25): Max results Returns: matching skills with their numeric ID, name and category. Use when: "Find the skill ID for n8n",

• freelancer_send_messagewrite action

  Send a message in an existing Freelancer.com thread. Args: - thread_id (string | number): The thread ID to reply to, or a Freelancer.com chat link containing one - message (string): Your message text - account (string, optional): … This is the account the message is sent FROM. Returns: confirmation with message ID ⚠️ This sends a real message from your account. Use when: "Reply to thread 12345 say

• freelancer_set_skills

  Replace your ENTIRE skill list with the provided skills. Any current skill not in the list is removed. Args: - skills (string[]): The complete set of skill names or numeric IDs your profile should have. - account (string, optional): … Returns: confirmation. ⚠️ Destructive: this overwrites all existing skills. Consider freelancer_list_skills first, and freelancer_add_skills if you only want to appe

• freelancer_update_profilewrite action

• Code scan23 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 82 days ago12/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Safety score

78/100

higher than 62% of 3,470 Web search servers

Tools

21

the typical Web search server has 5

Tools that change things

24%

typical: 0%. Fewer write tools means less an agent can break

GitHub stars

1

more than 55% of 1,786 Web search servers

Downloads a week

45

more than 31% of 827 Web search servers with a package

Freelancer: common questions

Is Freelancer MCP server safe?

Mostly: it is graded B (78/100). Read the Freelancer safety report

How do I install Freelancer?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Freelancer need an API key?

Yes. The registry entry asks for FREELANCER_OAUTH_TOKEN, FREELANCER_ACCOUNTS.

Is Freelancer maintained?

The last commit was 121 days ago (2026-07-06). The latest release is v2.0.0.

What can I use instead of Freelancer?

Servers from other publishers that do the same job: Exa MCP server, Chatroost — unofficial Telegram MCP server and searxNcrawl MCP server.

How does Freelancer compare with other Web search MCP servers?

safety score 78/100 (higher than 62% of 3,470 Web search servers); tools 21 (the typical Web search server has 5); tools that change things 24% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.