The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Flconsole — Upwork jobs listing page.
New Upwork jobs for Claude Code, Codex, Cursor and the Claude app.
Your agent finds new jobs, reads them and shows you the ones that fit.
Website · Docs · Telegram bot
flconsole is a free service that watches new Upwork jobs and delivers matching ones to your Telegram or to your AI agent over MCP.
This repository holds ready-to-paste configs and a short guide. The server is hosted — there is nothing to install or run.
Add --scope user to use it in all your projects. Then run /mcp → flconsole → Authenticate.
Guide: flconsole in Claude Code · file: configs/claude-code.sh
The second command opens the sign-in page in your browser.
Guide: flconsole in Codex · file: configs/codex.sh
Web, desktop and mobile: Settings → Connectors → Add custom connector, paste the server URL:
Guide: flconsole in the Claude app
Add to ~/.cursor/mcp.json, then sign in when Cursor asks:
Guide: flconsole in Cursor · file: configs/cursor.mcp.json
Any MCP client with Streamable HTTP works. If it supports sign-in (OAuth), add the server URL and sign in as below. If it doesn't, use a manual token: in the Telegram bot send /mcp → Manual token (other apps), then send it as Authorization: Bearer <token>.
Examples: configs/manual-token.claude-code.sh, configs/manual-token.codex.toml.
Through Telegram — no password, no API key:
The sign-in link works for 10 minutes. Disconnect any app later in the bot: /mcp → Disconnect.
| Tool | What it does |
|---|---|
find_jobs | New jobs by a feed, all feeds or any filters |
get_job_details | Full data for the jobs you picked |
list_feeds | Your feeds with filters and status |
create_feed | Creates a feed; needs your approval |
update_feed | Changes, pauses or resumes a feed |
delete_feed | Deletes a feed; needs your approval |
preview_filters | How many jobs matched in the last hours, with samples |
parse_upwork_url | Turns an Upwork search link into filters |
list_categories | Upwork categories and subcategories |
find_locations | Countries and regions by name |
get_usage | What's left of your limits |
Arguments, filters and job fields: MCP reference.
On a schedule in Claude Code:
Upwork has its own MCP server for actions in your account. Use flconsole to find new jobs and Upwork's MCP to send proposals: your agent never runs repeated searches from your Upwork account. A freelancer reports a policy violation after checking Upwork's MCP for new jobs every 15 minutes.
Setup: flconsole + Upwork's MCP
| Limit | |
|---|---|
| Feeds | 5 (shared with Telegram) |
find_jobs | 100 jobs an hour, 1,000 a day, one call every 60 seconds |
get_job_details | 30 jobs an hour |
| Feed changes | 20 an hour |
preview_filters | 10 an hour |
parse_upwork_url | 30 an hour |
| Connections | 5 apps at a time |
get_usage shows what's left.
The configs and text in this repository are under the MIT License. The hosted service follows its terms of use.