upwork-mcp

Un servidor MCP para la automatización de Upwork. Busca empleos, redacta y envía propuestas, gestiona mensajes y contratos, todo desde Claude Desktop o cualquier cliente compatible con MCP.

Características

• Búsqueda de empleos — búsqueda por palabras clave con filtros (presupuesto, tarifa horaria, nivel de experiencia, calificación del cliente, antigüedad), puntuación automática y detección de señales de alerta.

• Flujo de trabajo de propuestas — redacta a partir de plantillas, previsualiza y envía con confirmación explícita; límite diario aplicado.

• Evaluación de clientes — comprobador de 7 condiciones de alerta (verificación de pago, calificación, historial de contrataciones, antigüedad de la cuenta, número de republicaciones, volumen de propuestas, tarifa horaria mínima).

• Mensajes — lista de conversaciones no leídas, lectura de hilos, redacción y envío de respuestas.

• Contratos — lista de contratos activos/pasados, visualización de detalles y entradas del diario de trabajo.

• Seguridad de sesión — perfil de Chromium persistente, detección de Cloudflare, caducidad por inactividad de 7 días, restricción de dominio a upwork.com.

• Registro de auditoría — cada llamada a herramienta se añade a ~/.upwork-mcp/audit.log (solo metadatos, sin contenido).

Requisitos

• Python 3.11+

• uv (recomendado) o pip

• Una cuenta de Upwork válida

Instalación

Usando uv (recomendado)

git clone https://github.com/kubegrind/upwork-mcp
cd upwork-mcp
uv sync
uv run playwright install chromium

Usando pip

git clone https://github.com/kubegrind/upwork-mcp
cd upwork-mcp
pip install -e .
playwright install chromium

Configuración

Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "upwork": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/upwork-mcp",
        "run",
        "upwork-mcp"
      ]
    }
  }
}

Claude Code

claude mcp add upwork -- uv --directory /absolute/path/to/upwork-mcp run upwork-mcp

Variables de entorno

Autenticación

El servidor utiliza un perfil de navegador Chromium persistente. En la primera ejecución, autentícate manualmente:

uv run upwork-mcp --no-headless

Se abrirá una ventana del navegador. Inicia sesión en Upwork normalmente. La sesión se guarda en ~/.upwork-mcp/profile/ y se reutiliza en ejecuciones posteriores. Las sesiones caducan tras 7 días de inactividad.

Herramientas

Empleos

Propuestas

Mensajes

Contratos

Perfil

Sesión y Auditoría

Plantillas de propuestas

Las plantillas se encuentran en ~/.upwork-mcp/templates/. La plantilla predeterminada se carga desde default.txt si existe. Pasa un nombre de archivo a través de template_name para usar una plantilla personalizada.

Variables admitidas:

{job_title}         {client_name}       {key_skill}
{estimated_timeline} {rate}             {years_experience}
{industries}        {custom_paragraph}  {start_date}
{your_name}

Ejemplo de plantilla (~/.upwork-mcp/templates/default.txt):

Hi {client_name},

I noticed you're looking for {key_skill} help on {job_title}.
I have {years_experience} years of relevant experience and can deliver {estimated_timeline}.

My rate is {rate}.

{your_name}

Búsquedas guardadas

Crea archivos JSON en ~/.upwork-mcp/searches/ para guardar configuraciones de búsqueda:

{
  "query": "devops kubernetes",
  "experience_level": "expert",
  "budget_min": 500,
  "client_rating_min": 4.5
}

Ejecuta con upwork_run_saved_search(search_name="devops").

Puntuación de empleos

Los empleos se puntúan del 1 al 10 usando un modelo ponderado:

Los empleos con una puntuación inferior a 4.0 se filtran de los resultados. Los empleos con una puntuación de 7.0 o superior se marcan como [HIGH PRIORITY].

Seguridad

• Herramientas de ESCRITURA (submit_proposal, withdraw_proposal, send_message, close_session, rotate_session) requieren confirmed: true — el modelo no puede actuar sin la confirmación explícita del usuario.

• Límite diario de propuestas — bloqueo estricto a 10 envíos por día.

• Restricción de dominio — la navegación del navegador está restringida a upwork.com.

• Sin exposición de credenciales — las cookies y los tokens nunca se devuelven, registran ni imprimen.

• Protección contra recorrido de rutas — los nombres de archivo de plantillas y búsquedas guardadas se validan con Path.is_relative_to().

• Registro de auditoría — todas las llamadas a herramientas se registran con marca de tiempo, tipo de acción, destino y estado.

Desarrollo

uv sync --extra dev
uv run pytest
uv run ruff check src
uv run mypy src

Licencia

MIT