Skip to content

Upwork MCP Server for Claude: Setup, What It Can Do, and Its Limits

In August 2026 Upwork released an official MCP server, so Claude can search jobs, read client histories and draft proposals inside your own Upwork account. I connected it and used it end to end in November 2026: searching, scoring jobs, and submitting a real proposal. This page covers what I found, from the freelancer side.

The server is hosted by Upwork at https://mcp.upwork.com/mcp, and the connector itself is free.

  • Claude app: add Upwork from the connectors directory, sign in to Upwork and authorize.
  • Claude Code: run claude mcp add --transport http upwork https://mcp.upwork.com/mcp, then /mcp in a session to sign in.

The first call to make is the account list, because every other tool needs your account id from it.

TaskWhat you get
Keyword searchUp to 10 jobs per page with budget, client country, spend, rating, verification and hiring activity
Recommended jobsUpwork’s own Best Match and Most Recent feeds for your profile
Job detailsFull description, screening questions, the Connects cost to apply, and the client’s hiring record (hires, spend, hire rate)

Three details that are easy to miss:

  • Keyword search has no date filter. Sort by recency and check each job’s posted date. Only the recommended feed in Most Recent mode filters by days.
  • Proposal counts depend on your plan. On Freelancer Basic you see a range (“50+”, “20 to 50”), not an exact number.
  • The client’s hire count is not in search results. Open the job to get the real hiring record before you spend Connects.

Nothing is sent when Claude prepares a proposal. The server returns a preview with the cover letter, bid, attachments and the Connects it will cost, and the proposal only goes out after you confirm it. Connects are spent at that moment, not before.

A few things the preview asks for along the way:

  • Fixed-price jobs: whether you are paid by milestone or by project, and an acknowledgement of Upwork’s Dispute Assistance terms.
  • Attachments: files go through an Upwork upload page, not through the chat.
  • Boosting: the preview shows the real competing boost bids on that job and the minimum needed for a top slot. A boost is a bid, not a fixed fee.

Upwork’s own guidance for the connector is worth following closely:

  • Rate limits are shared across every agent connected to your account, and frequent scheduled searches can use up much of your daily limit.
  • No minute-by-minute polling. If Upwork slows or refuses requests, pause instead of retrying.
  • You choose the jobs. The agent can sort and summarise by your criteria, but it should not rank or pick jobs on its own.

In practice that suggests a simple pattern: run a handful of searches once or twice a day, score the results on criteria you wrote yourself, and approve every proposal by hand.

This is the rubric I use, out of 100. Adjust the weights to your own work.

CriterionPointsWhat earns them
Fit30The core ask is work you actually sell
Prototypable25A small working demo can be built in about two hours
Client quality20Verified payment, real hire history, reasonable spend and reviews
Budget15Stated, and worth the Connects
Competition10Few proposals so far, posted recently

I skip anything from unverified clients with no hires, anything asking for unpaid test work, and anything asking to move off Upwork.

The full story of my first run, from search to submitted proposal, is in the blog.