upwork-sync

Upwork Inbox Sync

The Upwork MCP runs on the user's machine, so the JobPilot web app cannot reach it. This skill is the bridge: read the account through the MCP, push it to the API, and the /upwork/inbox page shows it.

Read-only against Upwork. Never call a write tool here, and never confirm a preview.

Setup

1. Follow ../_shared/setup.md.
2. Follow ../_shared/upwork-mcp.md: confirm the tools are connected and resolve ORG_UID. Not connected → stop with the message that doc gives.

Step 1: Read the dashboard

get_freelancer_dashboard action check. One call returns invitations, offers, messages, matched jobs, contract updates and the Connects balance.

Where the dashboard is thin, fill in from the source list. Only call these when the dashboard did not carry the item:

• list_freelancer_proposals action invitations for pending invitations.
• list_offers action list for offers.
• get_messages action list_rooms with unread_only: true for unread threads.

Do not page for history. This mirrors what is new, not the whole account.

Step 2: Push the Connects balance

jobpilot-api PUT /api/upwork/account --data '{"connectsBalance": 74}'

Report the general Connects wallet only. Product credits are a separate balance spendable on one product, so never fold them into this number.

Step 3: Push the inbox

One call for the whole batch, up to 200 items. upworkId is Upwork's own id and keys the upsert, so re-running the skill refreshes rows instead of duplicating them. Post even when the dashboard held nothing new: this call is what marks the mirror fresh, and an empty batch still counts.

Write the body to "$JOBPILOT_TEMP/upwork-inbox.json":

{ "items": [
  { "upworkId": "<upwork id>", "kind": "invitation", "title": "<job title>", "clientName": "<client>",
    "jobUrl": "<url>", "body": "<message or brief>", "receivedAt": "2026-09-07T12:00:00Z",
    "raw": {} }
] }

jobpilot-api POST /api/upwork/inbox/sync --data @"$JOBPILOT_TEMP/upwork-inbox.json"