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.
Connecting it
Section titled “Connecting it”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/mcpin a session to sign in.
The first call to make is the account list, because every other tool needs your account id from it.
What the job tools return
Section titled “What the job tools return”| Task | What you get |
|---|---|
| Keyword search | Up to 10 jobs per page with budget, client country, spend, rating, verification and hiring activity |
| Recommended jobs | Upwork’s own Best Match and Most Recent feeds for your profile |
| Job details | Full 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.
Proposals are drafts until you confirm
Section titled “Proposals are drafts until you confirm”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.
The limits to respect
Section titled “The limits to respect”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.
How I score jobs
Section titled “How I score jobs”This is the rubric I use, out of 100. Adjust the weights to your own work.
| Criterion | Points | What earns them |
|---|---|---|
| Fit | 30 | The core ask is work you actually sell |
| Prototypable | 25 | A small working demo can be built in about two hours |
| Client quality | 20 | Verified payment, real hire history, reasonable spend and reviews |
| Budget | 15 | Stated, and worth the Connects |
| Competition | 10 | Few 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.