HR Partner
HR Partner is a human resources platform for managing employee records, leave, recruitment, performance, timesheets, expenses, and related company data.
Verdict
Common use cases
- Check who reports to a manager before 1:1s
- List employees out on leave this week
- Pull pending expense claims for budget review
- Find contact details for remote team members
- Review performance cycle status across departments
Integration
- Vendor
- HR Partner
- Category
- developer-tools
- Auth
- API_KEY
- Tools
- 10
- Composio slug
hr_partner
Tools
- Get Company
Return the connected HR Partner company's identity, subscription status, workforce counts, timezone, and optionally its custom fields and enabled modules.
- Get Employee
Return one employee's detailed HR profile, organization placement, manager, tags, contacts, addresses, and custom data by employee code.
- Get Recruitment Record
Return one detailed job, applicant, or application using an identifier from recruitment search results.
- List Employee Records
List employee contacts, addresses, goals, checklists, absences, assets, attachments, benefits, dependents, education, grievances, interviews, notes, positions, renewables, legacy reviews, skills, or training records.
- List Employees
Find employee summaries using name, organization, status, tag, manager, and employment-date filters. Returns the complete matching set because HR Partner does not paginate.
- List Expenses
Return expense claims as a detailed, summary, or transaction report with employee, organization, date, status, payment, category, and project filters.
- List Leave Data
List either leave requests or employee leave balances using only filters supported by the selected data type.
- List Performance Reviews
List performance-management review cycles by employee, organization, status, and review dates, optionally including selected reviewer forms and answers.
- List Timesheets
List timesheet sequences and entries by employee, organization, sequence dates, status, project, activity, and approval, export, or lock state.
- Search Recruitment
List jobs, applicants, applications for one job, or application stage changes using resource-appropriate recruitment filters.
Setup
Setup guide
- 11. In Switchy, open Settings → Integrations → MCP Servers and click Add Server. 2. Select HR Partner from the catalog. 3. Log into your HR Partner account, navigate to Setup → API, and generate a new API key with read permissions for Employees, Leave, Expenses, and Performance modules. 4. Paste the API key into Switchy's configuration field and click Connect. 5. Open any Project, type '@HR Partner get company' and send — you should see your organization name, timezone, and active employee count. 6. If the response is empty or errors, verify the API key has the correct module scopes in HR Partner's settings.
What teammates see: by default, memories from HR Partner are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Org Chart Snapshot
@HR Partner list employees in the Engineering department and include their manager names and job titles.
Leave Calendar
@HR Partner list leave requests approved for the next 14 days, grouped by employee name and leave type.
Expense Audit
@HR Partner list all expense claims with status pending, showing employee, submission date, total amount, and category.
New Hire Onboarding
@HR Partner get employee records for anyone hired in the last 30 days and show their onboarding checklist completion status.
Review Cycle Status
@HR Partner list performance reviews with a due date in the current quarter, including employee name, reviewer, and completion status.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@hrpartner show me all employees in the Engineering department who started in the last 90 days, including their managers and onboarding checklist status.
HR Partner returned 7 employees matching your criteria. All report to either Sarah Chen (VP Engineering) or Marcus Liu (Director, Platform). Five have completed their onboarding checklists; two (hired within the last 3 weeks) are at 60% and 40% completion respectively. The response includes employee codes, hire dates, current positions, manager assignments, and checklist progress for each record.
This example demonstrates filtered employee search combined with relational data (managers) and checklist tracking. Requires read:employees scope. HR Partner returns the full result set without pagination, so large departments may produce verbose output. Custom fields configured in your HR Partner account will also appear in results.
@hrpartner create a leave request for employee EMP-2847 requesting 5 days of annual leave from March 10-14, 2025, with the note 'Family vacation in Portland'.
Leave request created successfully. Request ID LVE-00342 has been submitted for Jane Martinez (EMP-2847) covering March 10-14, 2025 (5 business days). The request enters 'Pending' status and routes to her manager (David Kim) for approval per your workflow rules. Jane's remaining annual leave balance after approval would be 7 days. No conflicts detected with existing approved leave.
This write operation shows the MCP creating HR records with side effects: the request triggers approval workflows and decrements leave balances upon approval. Requires write:leave scope. The employee code must exist in your system. HR Partner's approval routing follows your configured hierarchy, which the MCP cannot override.
@hrpartner pull all performance reviews completed in Q4 2024 for the Product team, then summarize the top 3 skill gaps mentioned across reviewer feedback.
HR Partner returned 12 completed reviews for Product team members between October-December 2024. Analyzing reviewer comments and ratings across all forms: The three most frequently cited development areas are (1) stakeholder communication and influence skills (mentioned in 8 reviews), (2) technical depth in data analysis and SQL (6 reviews), and (3) prioritization and roadmap planning under ambiguity (5 reviews). Six employees received 'Exceeds Expectations' overall ratings; the remainder were 'Meets Expectations'.
This synthesis example pairs HR Partner's structured review data with AI reasoning to surface patterns humans might miss in individual reviews. Requires read:reviews scope. The quality of the summary depends on how consistently reviewers document feedback in your review forms. Custom review templates and rating scales are respected.
Use-case deep-dives
When HR Partner beats spreadsheets for distributed onboarding
A 12-person agency hiring its third remote engineer this quarter needs to track laptop shipment, Slack invites, and first-week check-ins without losing items in email threads. HR Partner's checklist and asset tools let the ops lead query "show onboarding tasks for employees hired in the last 30 days" and surface blockers in Switchy's shared workspace—no manual spreadsheet updates. The API key auth means the whole team sees live status without passing credentials. This breaks down if you need custom workflow triggers (HR Partner doesn't expose webhooks through this MCP), but for teams under 50 people running standard onboarding sequences, the 10-tool scope covers employee records, assets, and notes in one query. If your onboarding lives in Notion or Linear already, stick with those MCPs and skip the extra integration tax.
Pull expense reports when finance needs project breakdowns
A 6-person consultancy bills clients by project and needs to reconcile travel and software expenses at month-end. The finance lead uses Switchy to run "list expenses for Project Atlas submitted in March, grouped by employee" and exports the transaction report to their accounting tool. HR Partner's expense filters (category, project, payment status) mean the query returns clean data without manual tagging in a separate system. This works when your expense workflow already lives in HR Partner—if your team submits expenses through Expensify or Ramp, those platforms own the source of truth and this MCP adds friction. The sweet spot is 5-30 person teams where HR Partner is the system of record and finance needs ad-hoc slicing without building custom exports every month.
Query review status when managers need completion visibility
A 20-person startup runs annual reviews in Q4 and the head of people needs to see which managers haven't submitted forms two weeks before the deadline. Switchy queries "list performance reviews for 2024 cycle where status is incomplete, grouped by reviewer" and surfaces the laggards in the team channel. HR Partner's review-cycle filters (employee, org, status, date range) make this a 30-second lookup instead of chasing managers individually. The limitation: if you need to read or write individual review answers, the MCP only exposes forms "optionally"—you'll hit the API's read-only boundary for sensitive feedback. This MCP shines for process oversight (who's done, who's late) but not for analyzing review content or automating follow-ups. Teams over 100 people should evaluate dedicated performance platforms with richer analytics.
Frequently asked
What can the HR Partner MCP do in Switchy?
It pulls employee profiles, leave balances, expense claims, performance reviews, and recruitment records from your HR Partner account into Switchy prompts. You can query workforce data, check absence requests, review org structure, and surface custom fields without opening the HR Partner web app. The MCP reads data; it doesn't create employees or approve leave.
Do I need admin access to connect HR Partner?
You need an API key from HR Partner, which typically requires admin or super-user permissions in your account. HR Partner doesn't use OAuth; you generate the key in their settings and paste it into Switchy. If your HR Partner admin has locked down API access, ask them to provision a key for your team's Switchy workspace.
Can the MCP approve leave requests or update employee records?
No. The HR Partner MCP is read-only. It fetches employee data, leave balances, expense reports, and review cycles, but it can't approve absences, edit profiles, or create new records. If you need to change data, you still log into HR Partner or use their native approval workflows.
Why use this MCP instead of exporting CSV reports from HR Partner?
The MCP gives you live data inside Switchy prompts without manual exports. You can ask questions like "Who's on leave next week?" or "Show me pending expense claims over $500" and get current answers instantly. CSV exports go stale the moment you download them, and they require manual filtering in spreadsheets.
Who on the team should connect the HR Partner integration?
Whoever holds the HR Partner API key—usually your HR lead or office manager. That person connects it once in Switchy; then anyone in your workspace can query the data in prompts, subject to your Switchy access controls. The MCP doesn't create per-user seats in HR Partner.