Skip to main content
Glama

Rippling MCP Server

npm version License: MIT MCP GitHub

An open-source Model Context Protocol (MCP) server for the Rippling HR/IT/Finance platform. Connect any AI agent or LLM to your Rippling workspace — query employees, manage leave requests, view company structure, and more.

Features

  • 18 tools across 6 domains: Company, Employees, Organization, Leave, Groups, Activity

  • Bearer token auth — simple API token setup, no OAuth dance required

  • Rate limit aware — respects Rippling's rate limit headers

  • AI-friendly errors — structured error messages with actionable fix suggestions

  • TypeScript — full type safety, built with @modelcontextprotocol/sdk

Related MCP server: Runn MCP Server

Quick Start

1. Get a Rippling API Token

Go to Rippling > Settings > API Tokens > Create API Token. Copy the token.

2. Configure in Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "rippling": {
      "command": "npx",
      "args": ["-y", "rippling-mcp-server"],
      "env": {
        "RIPPLING_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

3. Use It

Ask Claude things like:

  • "List all employees in Engineering"

  • "Who has pending leave requests?"

  • "Show me the company org structure"

  • "What's Alice's PTO balance?"

Tools Reference

Company

Tool

Description

get_company

Get company details (name, address, locations)

list_departments

List all departments with hierarchy

list_work_locations

List work locations and addresses

Employees

Tool

Description

list_employees

List active employees (paginated)

get_employee

Get a specific employee by ID

list_all_employees

List all employees including terminated

search_employees

Search by name, email, title, or department

Organization

Tool

Description

list_teams

List teams and subteam relationships

list_levels

List position levels (IC, Manager, Executive)

list_custom_fields

List custom field definitions

Leave Management

Tool

Description

get_leave_balances

Get PTO/sick leave balances for an employee

list_leave_requests

List leave requests (filter by status, date, requester)

process_leave_request

Approve or decline a pending leave request

list_leave_types

List all leave types configured for the company

Groups

Tool

Description

list_groups

List all groups

create_group

Create a new group with members

update_group

Update group name or members

delete_group

Delete a group

Activity

Tool

Description

get_company_activity

Get activity events (hires, changes, terminations)

Configuration

Variable

Required

Default

Description

RIPPLING_API_TOKEN

Yes

—

Your Rippling API token

RIPPLING_BASE_URL

No

https://api.rippling.com/platform/api

API base URL

For sandbox/testing, set RIPPLING_BASE_URL to https://sandbox.rippling.com/api/platform/api.

Development

# Install dependencies
npm install

# Run in development mode
RIPPLING_API_TOKEN=your_token npm run dev

# Run tests
npm test

# Build for production
npm run build

# Type check
npm run lint

How It Works

This server wraps the Rippling Platform API (V1) and exposes it through the Model Context Protocol. When an AI agent calls a tool, the server:

  1. Validates the input using Zod schemas

  2. Makes authenticated requests to the Rippling API

  3. Handles rate limiting automatically

  4. Returns structured JSON responses (or actionable error messages)

Limitations

  • Employee endpoints are read-only (Rippling API V1 restriction)

  • API token permissions determine which fields are returned per employee

  • Rate limits are enforced by Rippling (monitor via response headers)

  • Leave request processing requires appropriate admin permissions

License

MIT

Contributing

Issues and PRs welcome.

Available Tools

19 tools
create_groupC

Create a new group with specified members

Inputs: name (required), spokeId (required), userIds (required).

delete_groupC

Delete a group by its ID

Inputs: groupId (required).

get_companyB

Get current company details including name, address, and locations

Inputs: no named parameters.

get_company_activityC

Get company activity events such as employee changes, onboarding, and offboarding

Inputs: startDate, endDate, limit.

get_employeeC

Get detailed information for a specific employee by their ID

Inputs: employeeId (required).

get_leave_balancesB

Get leave balances for a specific employee including PTO, sick leave, and other leave types

Inputs: roleId (required).

list_all_employeesA

List all employees including terminated ones. Useful for complete workforce history.

Inputs: limit, offset, ein.

list_custom_fieldsC

List custom field definitions configured in Rippling

Inputs: limit, offset.

list_departmentsC

List all departments in the organization with hierarchical structure

Inputs: limit, offset.

list_employeesB

List active employees with pagination. Returns employee details including name, title, department, and work email.

Inputs: limit, offset.

list_groupsB

List all groups in the organization

Inputs: no named parameters.

list_leave_requestsC

List leave requests with optional filters for status, date range, and requester

Inputs: status, startDate, endDate, requestedBy, +2 more.

list_leave_typesB

List all leave types configured for the company (PTO, sick, etc.)

Inputs: no named parameters.

list_levelsC

List position levels (e.g. Manager, Executive, Individual Contributor)

Inputs: limit, offset.

list_teamsB

List all teams with subteam relationships

Inputs: no named parameters.

list_work_locationsB

List all work locations with addresses

Inputs: no named parameters.

process_leave_requestC

Approve or decline a pending leave request

Inputs: requestId (required), action (required).

search_employeesA

Search employees by name, email, title, or department. Fetches all active employees and filters client-side.

Inputs: query (required), limit.

update_groupC

Update an existing group's name or members

Inputs: groupId (required), name, userIds.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 19 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting specific resources like employees, groups, leave, or company data. However, list_employees and list_all_employees could cause confusion as both list employees, with the latter including terminated ones, which might lead to misselection if the agent doesn't carefully read descriptions.

    Naming Consistency5/5

    Tool names follow a consistent verb_noun pattern throughout, such as create_group, list_employees, get_company, and process_leave_request. All use snake_case with clear, predictable naming conventions, making the set easy to navigate.

    Tool Count4/5

    With 19 tools, the count is slightly high but reasonable for an HR/employee management domain, covering groups, employees, leave, and company details. It's well-scoped without being excessive, though it borders on feeling heavy compared to typical 3-15 tool ranges.

    Completeness5/5

    The tool surface provides comprehensive coverage for HR operations, including CRUD for groups, extensive employee listing and search, leave management with balances and requests, and company/department/team structures. No obvious gaps exist for core workflows in this domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with BambooHR's API through natural language queries. Provides access to employee data, time off management, company files, and HR operations with comprehensive tools for workforce management.
      108 npm
      1
      MIT
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Connects AI assistants to the Runn.io resource planning platform to manage projects, people, assignments, and financial forecasts. It provides 37 tools for accessing real-time data and comprehensive reports with built-in caching and role-based access control.
      -
    • A
      license
      B
      quality
      C
      maintenance
      Enables Claude, Cursor, and other MCP clients to query PeopleForce HRIS data (employees, time-off, recruitment) via 27 read-only tools.
      28
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 50+ tools for interacting with Rippling's HR platform, including employee management, payroll, time tracking, benefits, recruiting, learning, devices, groups, and custom objects, all through natural language.
      MIT