BrightHR MCP. Manage employee records and time off via conversation.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
BrightHR. Manage your entire workforce lifecycle directly from your AI client. This server gives you programmatic access to employee records, salary data, training history, and absence logs for UK and ANZ businesses.
Check employee availability, list holiday requests, or record sickness absence—all without leaving your workflow.
What your AI agents can do
Check api health
Verifies the connection and operational status of the BrightHR API.
Get employee details
Retrieves specific, high-fidelity information about a single employee.
Get employee job details
Fetches job-related metadata, including job roles and department structures.
Retrieves detailed data for any specific employee, including their roles and department information.
Lists all recorded absences and manages planned holiday requests, checking real-time team availability.
Accesses and displays salary information for specific employees.
Provides company details and lists all current employees in the organization.
Accesses full directories of employee benefits and retrieves the complete history of employee training records.
Logs a new sickness or other absence record for an employee, maintaining accurate time records.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
019dd0c5check api health
Verifies the connection and operational status of the BrightHR API.
019dd0c5get employee details
Retrieves specific, high-fidelity information about a single employee.
019dd0c5get employee job details
Fetches job-related metadata, including job roles and department structures.
019dd0c5get employee salary info
Retrieves current and historical salary information for an employee.
019dd0c5get organization info
Retrieves high-level details about the entire company structure.
019dd0c5list absences
Lists all recorded absences, optionally filtering the results by a specific employee ID.
019dd0c5list configured webhooks
Lists all active webhooks set up within the BrightHR system.
019dd0c5list employee benefits
Displays the full list of benefits associated with a specific employee.
019dd0c5list employees
Generates a complete list of every employee currently registered in the system.
019dd0c5list holiday requests
Lists planned leave or holiday requests, with filtering options by employee ID.
019dd0c5list training records
Retrieves the complete history of training records for an employee.
019dd0c5record absence
Logs a new sickness or other unplanned absence record for an employee.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with BrightHR, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
BrightHR MCP Server gives your AI client direct access to your entire employee management system. You can manage your workforce lifecycle and pull employee data—all without leaving your workflow. Your agent handles the complexity of HR records, letting you check availability, pull salary details, or log time off straight from your conversation.
Getting Employee Profiles
- You can get specific, high-fidelity info on any single employee using
get_employee_details. You'll also pull job-related metadata, including department structures and job roles, withget_employee_job_details. - You'll see the full list of every employee in the system with
list_employees, and you can get high-level details about the entire company structure usingget_organization_info. - You can review an employee's full benefits package by running
list_employee_benefits.
Tracking Time Off and Absences
- You can list all recorded absences using
list_absences, and you can manage planned leave or holiday requests withlist_holiday_requests. - You'll check real-time team availability and log a new sickness or other unplanned absence record using
record_absence. - You can pull the complete training history for any employee with
list_training_records.
Reviewing Compensation and Organizational Data
- You can pull current and historical salary information for any employee by calling
get_employee_salary_info. - You can list all active webhooks set up in BrightHR with
list_configured_webhooks. - The server also lets you check the API connection status using
check_api_health.
Managing Records
- You can list every recorded absence using
list_absencesand filter those results by a specific employee ID. - You can list all planned holiday requests using
list_holiday_requestsand filter them by an employee ID. - You'll pull the entire employee directory using
list_employees.
How it works
- Subscribe to the BrightHR server.
- Pull your Access Token from your BrightHR dashboard (Settings > API or Developer Portal).
- Start managing HR tasks from your AI client. Your agent handles the API calls and presents the results directly in the chat.
How BrightHR MCP Works
- 1 Subscribe to the BrightHR server and retrieve your Access Token from the BrightHR Developer Portal.
- 2 Configure your AI client to use the server credentials.
- 3 Ask your AI agent a natural language question, like 'What are the holiday requests for John Doe?' The agent runs the necessary tool and returns the structured data.
The bottom line is, your AI client uses the BrightHR API to execute HR functions and gives you the results without you having to write any code or navigate any dashboards.
Who Is BrightHR MCP For?
HR Managers, Team Leaders, and Business Owners who need a single source of truth for workforce data. If you spend time toggling between HR dashboards to check who's available or reviewing an employee's full history, this is for you. It puts the data into conversation.
Runs reports on organizational structure, lists all employees, and checks salary details for compensation reviews.
Monitors holiday schedules and checks real-time team availability without leaving their chat window.
Automates oversight of organizational structure and employee compensation using simple AI queries.
What Changes When You Connect
- Check team availability instantly. Instead of checking a calendar dashboard, ask your agent to
list_holiday_requestsorlist_absencesto see who's out and when. It keeps you in your current window. - Automate reporting. Get a full organizational snapshot by calling
list_employeesand thenget_organization_info. You pull together data from multiple sources without manual copy-pasting. - Review employee history. Need to check past training or benefits? Use
list_training_recordsorlist_employee_benefitsto build a full view of an employee's development history. - Record time off in seconds. When someone calls out sick, use
record_absenceto log it immediately. The system updates the record right away. - Understand roles and pay. Use
get_employee_job_detailsto see a person's role, andget_employee_salary_infoto pull compensation details, all in one query. - Maintain system integrity. Run
check_api_healthto verify the API connection before relying on it, ensuring the data you get is accurate.
Real-World Use Cases
Scheduling a Team Meeting
A team leader needs to know if three people are free next week. They ask their agent, 'Who is available next Tuesday?' The agent runs list_holiday_requests and list_absences for those individuals, providing a consolidated availability report instantly.
Onboarding a New Hire
The HR manager needs to set up a new hire's profile. They ask their agent to run get_employee_details and get_employee_job_details to verify the new employee's full profile, job role, and department structure before finalizing the record.
Investigating Payroll Discrepancies
The payroll specialist sees a salary mismatch. They ask their agent to run get_employee_salary_info and cross-reference it with get_employee_details to pinpoint exactly where the data discrepancy is located.
Handling an Unexpected Absence
A manager receives a call about an employee being out sick. Instead of logging into the HR portal, they tell their agent, 'Log a sickness absence for Jane Doe starting tomorrow.' The agent executes record_absence and confirms the record.
The Tradeoffs
Manual Dashboard Toggling
Opening the BrightHR web dashboard, navigating to 'Employees,' filtering by 'Department X,' then opening the 'Absence' tab, and finally cross-referencing the 'Benefits' page. This takes 5-10 minutes.
→
Use your AI client. Ask it to 'List all employees in Marketing and show their next three holiday requests.' The agent runs list_employees and list_holiday_requests automatically and presents a single, summarized table.
Guessing Employee IDs
Trying to manually look up an employee's salary history by guessing their employee ID or searching through massive CSV exports, wasting time and risking data inaccuracy.
→
Simply ask your agent, 'What is the salary info for John Smith?' The agent uses get_employee_details to find the ID and then executes get_employee_salary_info automatically.
Ignoring System Status
Relying on a complex report that suddenly fails or returns incomplete data because the BrightHR API went down for maintenance or a minor glitch.
→
Always start by checking the connection. Run the check_api_health tool. If the tool reports issues, you know the data you pull from other tools is unreliable.
When It Fits, When It Doesn't
Use this server if you need to pull together disparate HR data points—like combining an employee's salary, their job title, and their pending leave—without logging into separate web applications. You need your AI client to act as a single, programmatic HR analyst. Don't use this if your only goal is to build a simple, read-only employee directory, as other, simpler directory tools might suffice. If you need to build complex, multi-stage, custom workflows that involve external systems outside of BrightHR, you'll need a more generalized integration layer. However, for pure BrightHR data, this is the definitive tool.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by BrightHR. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 12 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Managing employee data shouldn't mean juggling five different web tabs.
Right now, checking an employee's status means jumping between the main employee directory, the leave management calendar, the benefits portal, and the payroll system. You copy names, you switch tabs, you wait for each system to load, and you manually piece together the final picture.
With the BrightHR MCP Server, you ask your AI agent a question like, 'Show me Jane Doe's availability and salary.' The agent runs the necessary tools—`list_holiday_requests`, `get_employee_salary_info`—and hands you a single, compiled answer. It's immediate.
BrightHR MCP Server: Log Absence Records
Before, logging a sickness absence meant logging into the BrightHR portal, finding the employee, clicking 'Absence,' selecting the dates, and submitting the form. It's a multi-step, error-prone process.
Now, you just tell your agent, 'Log a sickness absence for John Doe starting tomorrow.' The agent executes `record_absence` directly. The record is logged instantly, and you move on. It's done.
Common Questions About BrightHR MCP
How do I list all employees using the BrightHR MCP Server? +
You use the list_employees tool. It returns a directory of every employee currently registered in your organization. You can then use get_employee_job_details on any of those IDs for more info.
Can I check if the BrightHR API is working with check_api_health? +
Yes, running check_api_health verifies the server's operational status. This confirms that the data you get from other tools is live and reliable before you build a report.
How do I see an employee's leave history with list_holiday_requests? +
Use the list_holiday_requests tool. You can filter the requests by an employee ID, which quickly shows all planned leave and absence records.
What is the difference between list_absences and list_holiday_requests? +
The list_holiday_requests tool shows planned time off. The list_absences tool covers actual logged absences, including sickness or unplanned time off.
Can I record a sickness absence using record_absence? +
Yes. The record_absence tool logs a new absence record for a specific employee, setting the start date and duration.
How do I get a specific employee's compensation details using get_employee_salary_info? +
This tool retrieves an employee's current salary structure. You get access to salary grade, pay frequency, and salary history metadata, which helps HR managers budget and plan compensation adjustments.
What information can I retrieve about a job role using get_employee_job_details? +
It pulls specific job metadata, including the job title's department affiliation, required seniority level, and associated job codes. This lets you understand the structural context of an employee's role.
How do I check for active system connections using list_configured_webhooks? +
This tool lists all active webhooks configured for your BrightHR account. You see the webhook URL, the event types it listens for, and the last time it successfully fired, which is useful for auditing system integration health.
How do I find my BrightHR Access Token? +
Log in to your account, navigate to Settings > API, or visit the BrightHR Developer Portal to generate a Personal Access Token.
Can I record a sickness absence via AI? +
Yes! The record_absence tool allows you to log an absence by providing the employee ID, reason, and start date programmatically.
How do I check upcoming holidays? +
Use the list_holiday_requests tool to retrieve all planned leave, with the option to filter by specific employee IDs.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Aero Workflow
Organize accounting firm tasks, track client work, and manage team workloads with purpose-built practice management.
ClickUp
Manage tasks and projects via ClickUp — track work, monitor spaces, and manage team productivity directly from any AI agent.
Google Drive: Folders & Shared Drives
Manage your Drive hierarchy — organize folders, manage Shared Drives, and create shortcuts via AI.
You might also like
Phrase (Software Localization API)
Manage software localization projects, locales, and translation keys directly through the Phrase API.
DOJ Civil Rights Data
Access Department of Justice civil rights data, including blog entries and press releases, directly from your AI agent.
Dify.AI SDK
Trigger and orchestrate Dify AI workflows, agents, and chatbots programmatically.