# Kwork

Kwork is a Claude Code MCP server that links a freelance marketplace profile to your assistant. Handles project discovery, dialogue monitoring, and proposal drafts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: simonether
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/simonether/kwork-mcp
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/kwork

## What it does

The server bridges your AI assistant with the marketplace through local stdio communication. The toolset lets the agent inspect available tasks, track remaining bids, inspect customer threads, and generate proposal drafts with specific costs and delivery windows.

Outbound updates rely on the `KWORK_WRITES` environment variable. By default, it operates in `confirm` mode, forcing the assistant to display the exact wording and pricing for explicit confirmation. Setting it to `off` strips modifying capabilities entirely, while `auto` allows hands-off submission.

Execution requires macOS or Linux, Python between 3.12 and 3.14, and `uv`. Windows is unsupported. Credentials are entered once via an interactive CLI login prompt and never exposed inside client config files. The package defaults to kwork.ru, with kwork.com support enabled through `KWORK_SITE=com`.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `KWORK_EXPECTED_USER_ID`, `KWORK_EXPECTED_USERNAME`, `KWORK_WRITES`, `KWORK_SITE`, `KWORK_TIMEOUT`, `KWORK_STATE_DIR`, `KWORK_PERSIST_TOKEN`, `KWORK_RPS_LIMIT`, `KWORK_BURST_LIMIT`, `KWORK_ROUTE_RPS_LIMIT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env KWORK_EXPECTED_USER_ID=<KWORK_EXPECTED_USER_ID> --env KWORK_EXPECTED_USERNAME=<KWORK_EXPECTED_USERNAME> --env KWORK_WRITES=<KWORK_WRITES> --env KWORK_SITE=<KWORK_SITE> --env KWORK_TIMEOUT=<KWORK_TIMEOUT> --transport stdio kwork -- uvx kwork-mcp
```
Replace <…> with your own values. 20 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from kwork-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add kwork --env KWORK_EXPECTED_USER_ID=<KWORK_EXPECTED_USER_ID> --env KWORK_EXPECTED_USERNAME=<KWORK_EXPECTED_USERNAME> --env KWORK_WRITES=<KWORK_WRITES> --env KWORK_SITE=<KWORK_SITE> --env KWORK_TIMEOUT=<KWORK_TIMEOUT> -- uvx kwork-mcp
```
Replace <…> with your own values. 20 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from kwork-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kwork": {
            "command": "uvx",
            "args": [
                "kwork-mcp"
            ],
            "env": {
                "KWORK_EXPECTED_USER_ID": "<KWORK_EXPECTED_USER_ID>",
                "KWORK_EXPECTED_USERNAME": "<KWORK_EXPECTED_USERNAME>",
                "KWORK_WRITES": "<KWORK_WRITES>",
                "KWORK_SITE": "<KWORK_SITE>",
                "KWORK_TIMEOUT": "<KWORK_TIMEOUT>"
            }
        }
    }
}
```
Replace <…> with your own values. 20 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from kwork-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kwork": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "kwork-mcp"
            ],
            "env": {
                "KWORK_EXPECTED_USER_ID": "<KWORK_EXPECTED_USER_ID>",
                "KWORK_EXPECTED_USERNAME": "<KWORK_EXPECTED_USERNAME>",
                "KWORK_WRITES": "<KWORK_WRITES>",
                "KWORK_SITE": "<KWORK_SITE>",
                "KWORK_TIMEOUT": "<KWORK_TIMEOUT>"
            }
        }
    }
}
```
Replace <…> with your own values. 20 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from kwork-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e KWORK_EXPECTED_USER_ID=<KWORK_EXPECTED_USER_ID> -e KWORK_EXPECTED_USERNAME=<KWORK_EXPECTED_USERNAME> -e KWORK_WRITES=<KWORK_WRITES> -e KWORK_SITE=<KWORK_SITE> -e KWORK_TIMEOUT=<KWORK_TIMEOUT> kwork uvx kwork-mcp
```
Replace <…> with your own values. 20 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from kwork-mcp <command>

## When to use it
- find relevant freelance gigs by budget thresholds and keywords
- draft bids with specified delivery timelines and price tags
- check ongoing message threads for unread client updates
- inspect active orders and remaining connection credits

## Example prompts
- Find web scraping jobs with a minimum price of 10000
- Check my unread marketplace conversations and propose replies
- Draft an offer for project 3257238: 15000 price and 5 days delivery

## Similar
- [fluentive](https://affpapa.org/en/nevibecode/mcp/fluentive.md) — MCP server · 911 installs
- [spark-persona-freelancer](https://affpapa.org/en/nevibecode/skills/spark-persona-freelancer.md) — skill · 335 installs
- [Workix](https://affpapa.org/en/nevibecode/mcp/workix.md) — MCP server · ★ 9 repo stars
- [PeoplePerHour by Cotlet](https://affpapa.org/en/nevibecode/mcp/peopleperhour-by-cotlet.md) — MCP server · ★ 6 repo stars
- [motion-pricing](https://affpapa.org/en/nevibecode/skills/motion-pricing.md) — skill · 1100 installs
- [creative-brief](https://affpapa.org/en/nevibecode/skills/creative-brief.md) — skill · 1100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
