Upwork API Automation Toolkit for Freelancers
Automate and streamline your Upwork freelancer workflow using the Upwork API directly from the terminal.

Upwork API Automation Toolkit for Freelancers

This Python package helps Upwork freelancers automate their daily workflows using the official Upwork API. It is designed to boost efficiency and reduce manual effort by providing programmable access to common tasks and events on the platform.

Features:

• Fetch and display public reviews from your Upwork profile for your personal portfolio
• Set up real-time alerts for:
  • New messages from clients with active contracts
  • Invitations to interview
  • General inbox messages
• Periodically scan job posts using custom filter logic and notify you with relevant links
• Retrieve and monitor personal data such as:
  • Earnings
  • Work diary
• Automate common actions via the command line

Whether you're an experienced freelancer or just starting out, this tool helps you stay responsive, informed, and efficient — all while remaining compliant with Upwork’s terms of service.

Setup Requirement

1. Get an API Key from upwork https://www.upwork.com/developer/keys/apply
2. Set an environment variable export UPWORK_API_KEY=<your-upwork-api-key>
3. Set an environment variable export UPWORK_API_SECRET=<your-upwork-api-secret>
4. Install this package from pypi pip install upwork-cli

Usage

upwork-cli or upcli can be used to run this tool from terminal.

use upcli --help to view the available options and commands.

🧪 Project Structure

📁 upwork-cli/
├── 📁 src/
│   └── 📁 upwork_cli/
│       ├── __init__.py
│       ├── __main__.py
│       ├── __init__.py
├── 📁 examples/
│   └── sample_usage.py
├── 📁 tests/
│   └── test.py
├── ⚙️ .env
├── 🚫 .gitignore
├── 📃 LICENSE
├── 📃 LICENSE.txt
├── ⚙️ pyproject.toml
├── 📝 README.md
└── ⚙️ ruff.toml

📄 License

Licensed under the MIT License.

🤝 Contributing

• Open an issue for ideas, bugs, or suggestions.
• Pull requests are welcome!

🔗 Links

• 📦 PyPI
• 🛠️ Issues
• ⭐ Star on GitHub