# Rippling MCP > Rippling MCP manages your entire workforce directly from your AI client. List employees, update profiles, and organize departments using natural conversation. It lets you maintain precise HR records without ever leaving your chat window. ## Overview - **Category:** human-resources - **Price:** Free - **Tags:** hr-management, employee-directory, workforce-automation, department-management, rippling-api ## Description Connecting Rippling to your agent lets you handle day-to-day employee management through simple talk. You can list all current personnel or pull deep data on a specific individual's profile. Need to update someone’s role or department? Just ask, and the changes happen instantly. You can also map out your company structure by listing departments or fetching details about associated companies. If you're using Vinkius for your catalog of tools, this MCP plugs Rippling into that ecosystem so everything just works. ## Tools ### create_department Adds a new department record into the company's structure. ### get_company Pulls specific details for one named company. ### get_employee Retrieves all available data points for a single employee using their ID. ### list_companies Shows a list of every company associated with the account. ### list_departments Outputs a full roster of all departments currently defined. ### list_employees Generates a complete list view of every current employee in the company. ### update_employee Changes specific information fields for an existing employee record. ## Prompt Examples **Prompt:** ``` List all employees currently in the company. ``` **Response:** ``` I've retrieved the employee list. You have 45 active employees. Notable entries include 'Alice Smith' (ID: emp_001) and 'Bob Jones' (ID: emp_002). Would you like to see details for a specific person? ``` **Prompt:** ``` Get the full profile for employee ID 'emp_12345'. ``` **Response:** ``` Fetching details for employee emp_12345... I've found the record for Jane Doe. She is a Senior Engineer in the Product department, based in San Francisco. Would you like to update any of her information? ``` **Prompt:** ``` Show me all the companies associated with my account. ``` **Response:** ``` I found 2 companies associated with your token: 'Acme Corp' (ID: comp_987) and 'Acme Logistics' (ID: comp_654). Which one would you like to inspect further? ``` ## Capabilities ### List all personnel Retrieve a comprehensive roster of every employee currently working in the organization. ### Get specific employee details Fetch deep records, including roles and metadata, for any individual using their unique ID number. ### Modify employee profiles Make direct changes to an existing employee's information, keeping the HR record current in real-time. ### Organize teams and departments See a list of all existing work departments or create brand new ones instantly. ### Map out corporate structure Retrieve information about associated companies, including their organizational hierarchy. ## Use Cases ### Auditing employee status changes The HR Manager needs to confirm who reported changing departments last quarter. They ask the agent to list all employees, then request specific metadata for each person to verify their current department and manager ID. ### Onboarding a new team structure An Operations Lead realizes two teams should report under one larger unit. They use the agent to create_department 'West Coast Ops' and then update_employee records for all affected personnel, completing the restructuring in minutes. ### Troubleshooting a data discrepancy An IT Admin notices an employee ID is missing key details. They ask to get_employee details first, spot the gap, and then use update_employee to add the necessary information without opening any web portals. ### Mapping out subsidiary relationships The executive needs a quick overview of all corporate entities. They use list_companies to see everything and then get_company details on each one to understand their relationship status. ## Benefits - Never switch tabs to check on an employee. You can list all employees or fetch a deep profile for one person using the agent, keeping everything in your current conversation stream. - Keep HR records accurate without manual data entry. Use the update_employee tool to change job titles, departments, or contact info instantly when you spot a discrepancy. - Map out your entire corporate structure efficiently. You can list companies and then retrieve details for specific associated companies, giving instant visibility into organizational links. - Department management is simple. Need to organize people? The agent lets you list departments or create brand-new ones with just a few words. - Get the full picture of your organization's hierarchy. You can access metadata on both employees and companies, helping Ops Leads understand reporting lines quickly. ## How It Works The bottom line is you use your AI client as the single pane of glass to manage complex HR data without ever logging into Rippling itself. 1. Subscribe to this MCP and enter your Rippling Access Token. 2. Start talking to the agent in any MCP-compatible client (like Claude or Cursor). 3. Ask for a specific HR action—for example, 'List all employees'—and get the data back immediately. ## Frequently Asked Questions **How does Rippling MCP handle access tokens?** You subscribe to this MCP and provide your Rippling Access Token during setup. This token authorizes your agent to perform actions on your behalf within the system. **Can I use Rippling MCP to add a new company?** No, this MCP does not have a tool specifically for adding a whole new company. However, you can list_companies and get details about existing ones. **What if I need an employee's profile but only know their name?** While the agent prefers unique IDs, you can start by using list_employees to narrow down the roster, or try getting a partial record of the person first. **Does Rippling MCP let me see department hierarchies?** Yes. You can use list_departments and then get metadata on specific employees to understand how departments relate to each other and to companies. **Is updating an employee's record safe through the MCP?** The process is secure, provided you connect your token correctly. The update_employee tool executes changes directly within Rippling using API standards.