How do I install the rippling mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `RIPPLING_API_TOKEN`, `RIPPLING_BASE_URL` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Rippling MCP Server

MCP server for Rippling HR/IT/Finance platform — employees, departments, leave management, groups, and company data

Local serverstdioTypeScript

What is the Rippling MCP Server?

MCP server for Rippling HR/IT/Finance platform — employees, departments, leave management, groups, and company data

What you get

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

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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
get_company	Get company details (name, address, locations)
list_departments	List all departments with hierarchy
list_work_locations	List work locations and addresses
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
list_teams	List teams and subteam relationships
list_levels	List position levels (IC, Manager, Executive)
list_custom_fields	List custom field definitions
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
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
get_company_activity	Get activity events (hires, changes, terminations)

How to install the Rippling MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
RIPPLING_API_TOKEN	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use Rippling MCP to Company.”
“Use Rippling MCP to Employees.”
“Use Rippling MCP to Organization.”

Frequently asked questions

MCP server for Rippling HR/IT/Finance platform — employees, departments, leave management, groups, and company data Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.