Rippling a MCP: empleados, estructura organizativa, compensación, ausencias y registros de tiempo en cualquier agente de IA

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Rippling, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Rippling

La plataforma de RR. HH. Rippling a través de su REST API: workers y usuarios, departamentos, equipos, centros de trabajo, niveles, puestos, tipos de empleo y campos personalizados, compensación, tipos, saldos y solicitudes de ausencia, supergroups y registros de tiempo. Además registra y aprueba ausencias, registra horas, mantiene la estructura organizativa y crea draft hires.

Configuración

La configuración lleva unos 5 minutos. Necesitas un usuario de Rippling con el permiso Create and manage API Tokens y acceso a los datos que la IA debe leer.

1. En Rippling abre Developer > API credentials (https://app.rippling.com/api-tokens/tokens) y haz clic en New API token.
2. Ponle un nombre al token y elige sus scopes. El token solo llega a los datos que permiten a la vez sus scopes y el perfil de permisos de su propietario. Elige lo que uses:
   • companies.read (obligatorio, la comprobación de instalación), más workers.read, users.read, departments.read, teams.read, work-locations.read, levels.read, titles.read, employment-types.read, job-codes.read, custom-fields.read, supergroups.read.
   • compensations.read solo si la IA debe ver los salarios.
   • leave-types.read, leave-balances.read, leave-requests.read y leave-requests.read-write para registrar o aprobar ausencias.
   • time-entries.read y time-entries.read-write para registrar tiempo (requiere Rippling Time).
   • departments.read-write, teams.read-write, work-locations.read-write y draft-hires.read-write para las escrituras correspondientes.
3. Copia el token enseguida (solo se muestra una vez) en RIPPLING_API_TOKEN, sin Bearer. Instala el conector: rippling_list_companies es la comprobación de instalación.

Las peticiones se ejecutan como el propietario del token. Rippling revoca un token que pasa 30 días sin usarse y los tokens de un propietario que deja la empresa, así que elige un propietario con un acceso estable.

Datos personales: workers, usuarios y paquetes de compensación contienen datos personales y salariales: nombres, emails privados, teléfonos, domicilios, fecha de nacimiento, género y salario. Pide solo los campos que necesita la tarea, no los copies a otros sistemas sin motivo y da al token solo los scopes que usa el equipo.

Qué lee: la empresa (rippling_list_companies); los workers, es decir, las relaciones laborales de empleados y contratistas, con estado, email de trabajo y personal, fecha de alta y de baja, puesto, departamento, responsable, nivel, equipos, ubicación, tipo de empleo y país (rippling_list_workers, rippling_get_worker); los usuarios, la identidad de acceso detrás del user_id de un worker (rippling_list_users, rippling_get_user); los paquetes de compensación con importes anuales, mensuales, semanales y por hora, objetivos de bonus y comisiones (rippling_list_compensations y rippling_get_compensation con el compensation_id del worker); las definiciones de campos personalizados (rippling_list_custom_fields), cuyos valores llegan con expand=custom_fields en los workers; la estructura organizativa con departamentos, equipos, centros de trabajo, niveles, puestos, tipos de empleo y job codes; los supergroups y sus miembros; los tipos de ausencia, los saldos en horas y días y las solicitudes de ausencia; los registros de tiempo con job shifts, pausas, duración, estado y periodo de pago. expand (por ejemplo user,manager,department) incrusta los objetos relacionados en una sola llamada.

Qué escribe:

• Ausencias: rippling_create_leave_request registra una ausencia para un worker (PENDING sigue el flujo normal de aprobación, APPROVED registra una ausencia ya acordada); rippling_update_leave_request la aprueba, rechaza o cancela mediante status, o cambia sus fechas y comentarios.
• Tiempo: rippling_create_time_entry registra tiempo trabajado como job shifts con hora de inicio y fin o como duración en un día; acepta un idempotency_key para que un reintento no cree un duplicado. rippling_update_time_entry cambia un registro; la API exige worker_id aunque no cambie.
• Estructura organizativa: rippling_create_department, rippling_update_department, rippling_create_team, rippling_update_team, rippling_create_work_location y rippling_update_work_location. Las actualizaciones solo cambian los campos enviados.
• Contratación: rippling_create_draft_hires crea hasta cinco draft hires, que pasan por la revisión y aprobación de Rippling antes de que se contrate a nadie.

Desactivadas al instalar: rippling_delete_team (los workers pierden la asignación al equipo) y rippling_delete_time_entry. Ninguna se puede deshacer; un administrador del workspace las activa cuando el equipo las necesita.

Filtros: filter acepta una expresión estilo OData sobre los campos que indica cada herramienta, por ejemplo status eq 'ACTIVE', updated_at ge 2026-01-01T00:00:00 o status in ('HIRED','ACCEPTED'), combinada con and y or. Las cadenas van entre comillas simples y un filtro tiene como máximo 64 nodos. Saldos de un worker: worker_id eq '...'; solicitudes pendientes: status eq 'PENDING'.

Formatos de datos: los ids son cadenas hexadecimales de 24 caracteres. Las fechas son YYYY-MM-DD y las marcas de tiempo ISO 8601 con desfase. El dinero es { "currency_type": "USD", "value": 120000 } en unidades enteras de la moneda. El status del worker es INIT, HIRED, ACCEPTED, ACTIVE o TERMINATED. Un campo que el token no puede ver vuelve como null y aparece con el motivo en __meta.redacted_fields, así que null no demuestra que el campo esté vacío: revisa primero los scopes y los permisos del propietario.

Paginación: las listas responden con results y next_link, 50 elementos por defecto y hasta 100 con limit. Mientras next_link no sea null, la IA vuelve a llamar con cursor igual al valor del cursor dentro de next_link.

Límites y errores comunes: 600 peticiones cada 10 segundos por endpoint y token, después 429 (espera unos segundos y reintenta). 400 indica un filtro incorrecto, un campo que no se puede expandir o limit mayor que 100; 401 un token erróneo o revocado; 403 un scope que falta o un permiso que el propietario no tiene; 404 un id desconocido.

El conector no edita los datos de los workers ni la compensación, no contrata ni despide a nadie directamente y no procesa nóminas.

Requisitos previos: RIPPLING_API_TOKEN

Instalar el conector localmente

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Abre http://localhost:3000/connectors/store, elige Rippling e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "¿Quién se ha incorporado en los últimos 30 días? Lista nombre, puesto, departamento, responsable y fecha de alta."
• "Muéstrame todas las solicitudes de ausencia pendientes con worker, fechas, horas y tipo de ausencia."
• "¿Cuántas vacaciones le quedan a Maria Lopez, en días y en horas?"
• "Aprueba la solicitud de vacaciones pendiente de Maria Lopez del 10 al 14 de noviembre."
• "¿Cuántos workers activos tenemos por departamento y centro de trabajo?"

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT