MCP server for Freelancer.com — search & bid on projects, read/send messages, multi-account support. Works with Claude Code and Claude Desktop.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add freelancer --env FREELANCER_OAUTH_TOKEN='<FREELANCER_OAUTH_TOKEN>' --env FREELANCER_ACCOUNTS='<FREELANCER_ACCOUNTS>' -- npx -y freelancer-mcp-server~/.codex/config.toml
[mcp_servers.freelancer]
command = "npx"
args = ["-y", "freelancer-mcp-server"]
env = { FREELANCER_OAUTH_TOKEN = "<FREELANCER_OAUTH_TOKEN>", FREELANCER_ACCOUNTS = "<FREELANCER_ACCOUNTS>" }
# codex mcp add freelancer --env FREELANCER_OAUTH_TOKEN='<FREELANCER_OAUTH_TOKEN>' --env FREELANCER_ACCOUNTS='<FREELANCER_ACCOUNTS>' -- npx -y freelancer-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"freelancer": {
"command": "npx",
"args": [
"-y",
"freelancer-mcp-server"
],
"env": {
"FREELANCER_OAUTH_TOKEN": "<FREELANCER_OAUTH_TOKEN>",
"FREELANCER_ACCOUNTS": "<FREELANCER_ACCOUNTS>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"freelancer": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"freelancer-mcp-server"
],
"env": {
"FREELANCER_OAUTH_TOKEN": "<FREELANCER_OAUTH_TOKEN>",
"FREELANCER_ACCOUNTS": "<FREELANCER_ACCOUNTS>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"freelancer": {
"command": "npx",
"args": [
"-y",
"freelancer-mcp-server"
],
"env": {
"FREELANCER_OAUTH_TOKEN": "<FREELANCER_OAUTH_TOKEN>",
"FREELANCER_ACCOUNTS": "<FREELANCER_ACCOUNTS>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"freelancer": {
"command": "npx",
"args": [
"-y",
"freelancer-mcp-server"
],
"env": {
"FREELANCER_OAUTH_TOKEN": "<FREELANCER_OAUTH_TOKEN>",
"FREELANCER_ACCOUNTS": "<FREELANCER_ACCOUNTS>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"freelancer": {
"command": "npx",
"args": [
"-y",
"freelancer-mcp-server"
],
"env": {
"FREELANCER_OAUTH_TOKEN": "<FREELANCER_OAUTH_TOKEN>",
"FREELANCER_ACCOUNTS": "<FREELANCER_ACCOUNTS>"
}
}
}
}Environment variables
FREELANCER_OAUTH_TOKENFREELANCER_ACCOUNTS
Replace the placeholders with your own credentials and keep them out of version control.