UpHunt - AI-Powered Freelance Job Platform
UpHunt
Back to Blog
about 23 hours ago·8 min read

UpHunt Team

Share

How to Connect Upwork MCP to Claude (2026 Setup Guide)

Short answer: In Claude on the web or Desktop, open Customize, then Connectors, find Upwork in the directory and click Connect. Or add it by hand as a custom connector with the server URL https://mcp.upwork.com/mcp. In Claude Code, run claude mcp add --transport http upwork https://mcp.upwork.com/mcp, then /mcp to sign in. You log in with your own Upwork account, and every proposal waits for your approval before it is sent.

Upwork's MCP server is Upwork's own connector for AI agents. Upwork says it is "free to use with any Upwork account" and that it is "the only official connector for AI agents" (Upwork MCP page). Here is how to set it up in Claude, what it can do for a freelancer, and the limits worth knowing before you lean on it.

What you need before you start

  • An Upwork account. There are no API keys. Upwork says "Every Upwork MCP user must sign in with their own Upwork account through OAuth" and the MCP "doesn't accept API keys, including keys issued for the Upwork API" (Upwork MCP page).
  • A Claude account. Upwork's Claude help article says "Our connector is available to all Claude users, even if you use the free plan" (Upwork Help). If you add it by hand as a custom connector, Upwork's setup page notes that "Free plan users are limited to one custom connector" (Upwork MCP page).
  • On Claude Team or Enterprise: "an Owner must add the connector first via Organization Settings → Connectors, after which members connect individually" (Upwork MCP page).

Option 1: Claude on the web or Desktop (directory)

This is the route Upwork recommends.

  1. Open claude.ai/directory/connectors/upwork, or in the Desktop app go to Customize → Connectors → Add → Browse connectors and search for Upwork.
  2. Click Connect.
  3. Log in to Upwork in the window that opens and authorize the connection.

To use it in a chat, Upwork says to "click + in the chat input, choose Connectors, and enable Upwork" (Upwork MCP page).

Option 2: add it by hand as a custom connector

If the directory listing dosn't show up for you, add the server yourself:

  1. Go to claude.ai/customize/connectors, or Customize → Connectors in the Desktop app.
  2. Click Add, then Add custom connector.
  3. Name: Upwork. Server URL: https://mcp.upwork.com/mcp
  4. Click Add, then Connect, then log in to Upwork and authorize.

That URL is the whole install. Upwork hosts the server, "so there's no local install" (Upwork MCP page).

Option 3: Claude Code

Run this in your terminal:

claude mcp add --transport http upwork https://mcp.upwork.com/mcp

Then open a Claude Code session and run /mcp to finish the Upwork login in your browser. Upwork also publishes an Upwork Agent Plugin that bundles the server with guided workflows, if you want ready-made steps for proposals and job posts.

What Claude can do with your Upwork account

For freelancers, Upwork lists these tasks for the connector (Upwork Help, Upwork MCP page):

  • Find work: search jobs by skill, category, budget or type, and pull matches from your Best Matches and Most Recent feeds.
  • Apply: draft and submit a proposal. "Claude shows the Connects cost before submitting."
  • Handle invites and offers: accept or decline invitations, and review an offer's terms. Accepting an offer is finished on upwork.com.
  • Run the work: message clients, check contracts and milestones, submit milestone work.
  • Keep your profile fresh: update your title, overview, skills and availability.

For agencies, Upwork adds an agency dashboard with "every team member's invitations, offers, messages, and contracts in one summary" (Upwork MCP page).

The confirm step: nothing sends on its own

Upwork's rule: "Claude prepares most actions (job posts, proposals, invitations, messages, milestones) as a draft you approve before anything is sent or published" (Upwork Help). On proposals, "Connects only apply when you confirm" (Upwork MCP page).

Some things never happen inside Claude. Accepting an offer, funding or approving a milestone payment and changing a contract's weekly hour limit all give you a link to finish on upwork.com.

If a confirmation fails, Upwork's advice is simple: "Don't assume your proposal was submitted." Check your submitted or pending proposals and your Connects balance. If neither changed, don't keep retrying. Contact Upwork Support with the job and the error (Upwork Help). We wrote more on what an agent is allowed to send and where automation crosses the line.

Upwork MCP rate limits

Upwork counts every action Claude takes as a request, per Upwork account. One prompt can be many requests: "find 10 jobs and summarize each" can be one search plus 10 reads. The current limits (Upwork Help):

CategoryPer minutePer hourPer day
Search and discovery15150750
Profile viewing575250
Other read operations20250750
Job posts, proposals, offers, invitations2060150
Other changes41540

A few details from the same article:

  • The daily period "starts at 00:00 UTC", and for now the limits are the same for every account: "Your membership plan, earnings, spend, and Job Success Score do not change the limits."
  • Hitting a limit now and then only rejects that request: "there is no penalty if you do so." But usage that "stays far above these limits" can get your MCP access throttled, suspended or terminated. Don't let Claude retry the same call over and over.
  • Connects still apply the same way they do on upwork.com, so the 150-a-day limit in the proposals row is a ceiling, not a budget. Our guide to Upwork Connects pricing has the cost side.

Upwork also says to avoid "automations that look for changes every few minutes." Upwork's MCP page says scheduled read-only searches are allowed, but each run may count toward your limits, and all your agents share one set (Upwork MCP page).

Prompts that work well

Write prompts that do one clear job, so you spend fewer requests:

  • "Search Upwork for hourly Python jobs posted today, newest first, and show the title, budget and client country for each."
  • "Open the third job and summarize what the client wants and their hiring history."
  • "Draft a short proposal for it from my profile. Don't submit, show me the draft and the Connects cost first."

Profile viewing has the lowest read limit (5 a minute), so search for a short list first, then open only the profiles you need.

Troubleshooting

  • Authentication error: Upwork says your token may have expired. Disconnect and reconnect the connector, and check you are signing in with the right Upwork account (Upwork MCP page).
  • Connector not showing: check the URL is exactly https://mcp.upwork.com/mcp. Some apps need a restart after you add a server.
  • Your own agent on a server: it may not be able to sign in yet. Upwork only accepts approved callback URLs, and "Callback URLs for agents you build yourself that run on a server or website can't be added right now" (Upwork MCP page).
  • To disconnect: go to Account Settings → Connected Apps on Upwork and remove it. That "immediately invalidates the access and refresh tokens" (Upwork MCP page).

What the Upwork MCP won't do: watch the feed for you

Upwork is clear that its MCP "doesn't add its own scores or rankings" (Upwork MCP page), and its rate-limit article says "Do not poll" (Upwork Help). So it is great for working a job you already picked, and a poor fit for catching new jobs the minute they post. We explain why in Upwork's API can't be your job feed.

That seperate job is what UpHunt does, on its own feed and outside Upwork's MCP. It watches new Upwork jobs in real time, scores each one from 1 to 10 with a plain-language reason, and sends instant alerts to Slack, Telegram or a webhook. You read the reason and decide which jobs are worth your Connects: you pick, not the agent. If you like working in Claude, the UpHunt MCP server brings that scored feed into Claude Desktop or Claude Code as a read-only list. Once you have picked a job, Upwork's connector is where you read it in full and send your proposal.

FAQ

What is the Upwork MCP server URL? https://mcp.upwork.com/mcp. It is hosted by Upwork and signs you in with OAuth.

Is the Upwork MCP free? Yes. Upwork says it is "free to use with any Upwork account." Standard Upwork fees apply, and proposals still cost Connects.

Can Claude submit proposals without my approval? No. Upwork says proposals are "drafted first, and nothing is sent until you confirm the draft."

Can I connect with an Upwork API key? No. Every user signs in with their own Upwork account through OAuth.

Does it work in the Claude mobile app? Upwork says if a mobile app can't add custom connectors, add it once on the web or desktop version and "it'll then be available in the mobile app automatically."

Does it work with ChatGPT or Cursor too? Yes. Upwork lists Claude (Web, Desktop, Code), ChatGPT, Cursor and Codex, with the same server URL.

Try UpHunt

Stop scrolling Upwork all day.

UpHunt scores every job 1-10 and auto-applies with personalized proposals 24/7. Set it up in 5 minutes.

Start Free Trial

Related Posts