MCP server

Breathe HR MCP by usefulapi

io.usefulapi/breathe-hr

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Read Breathe HR employees, absences, sickness and leave; create and review leave requests.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

25

Token cost

About 5,094 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http breathe-hr https://breathe-hr.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.breathe-hr]
url = "https://breathe-hr.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"breathe-hr":{"httpUrl":"https://breathe-hr.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"breathe-hr":{"url":"https://breathe-hr.usefulapi.io/mcp"}}}

VS Code

{"servers":{"breathe-hr":{"type":"http","url":"https://breathe-hr.usefulapi.io/mcp"}}}

Antigravity

agy mcp add breathe-hr https://breathe-hr.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"breathe-hr","server_url":"https://breathe-hr.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"breathe-hr","server_url":"https://breathe-hr.usefulapi.io/mcp"}

Tools

• breathehr_approve_leave_request ~153 tokens
  WRITE: approve a pending leave request; it becomes an absence and is deducted from the allowance. Recorded as done by the "API Employee". POST /leave_requests/{id}/approve.
• breathehr_create_leave_request ~423 tokens
  WRITE: request leave for an employee (holiday by default, or other leave). It is created as a request, then follows the account's approval rules; the employee's approver is notified. Each call creates a new request. POST /employees/{id}/leave_requests.
• breathehr_get_account ~76 tokens
  The Breathe HR account (company) this API key belongs to: id, name, domain and enabled modules. GET /account.
• breathehr_get_employee ~132 tokens
  One employee's record by id (personal and job details, contacts, manager, working pattern). Bank details and NI number are never returned. GET /employees/{id}.
• breathehr_get_holiday_years ~189 tokens
  An employee's holiday years: start/end, allowance, days or hours taken, booked and remaining. Pass for_date to get only the year that contains that date. GET /employees/{id}/employee_holiday_years.
• breathehr_get_leave_request ~111 tokens
  One leave request by id, with its status. GET /leave_requests/{id}.
• breathehr_list_absences ~439 tokens
  List approved absences (holiday and other leave) with employee, dates, half days, days deducted and cancelled flag. Filter by employee, department, type, other-leave reason and dates. GET /absences.
• breathehr_list_benefits ~249 tokens
  List employee benefits (type, value, start/end) for the whole company, one employee or one department. GET /benefits, /employees/{id}/benefits or /departments/{id}/benefits.
• breathehr_list_bonuses ~248 tokens
  List bonus records (amount, date, description) for the whole company, one employee or one department. GET /bonuses, /employees/{id}/bonuses or /departments/{id}/bonuses.
• breathehr_list_change_requests ~228 tokens
  List employee self-service change requests (field, requested value, approval state) for all employees or one employee. Requested values of bank and NI fields are redacted. GET /change_requests or /employees/{id}/change_requests.
• breathehr_list_departments ~156 tokens
  List the company's departments (id, name). Use the ids to filter absences, leave, sickness and pay. GET /departments.
• breathehr_list_divisions ~73 tokens
  List the company's divisions (id, name). All of them are returned in one reply. GET /divisions.
• breathehr_list_employee_jobs ~196 tokens
  List job history records (job title, start/end dates, department, location) for all employees or one employee. GET /employee_jobs.
• breathehr_list_employees ~235 tokens
  List employees with job title, department, division, location, line manager, holiday approver, working pattern, join/leaving dates and status. Bank details and National Insurance numbers are never returned. GET /employees.
• breathehr_list_expense_claims ~228 tokens
  List expense claims (employee, total, state, approver) filtered by employee and state. GET /employee_expense_claims.
• breathehr_list_expenses ~234 tokens
  List individual expense items (date, description, type, amount, VAT, project). By default only unclaimed items; set include_claimed to see all. GET /employee_expenses.
• breathehr_list_holiday_allowances ~106 tokens
  List the holiday allowance schemes (id, default flag, year_1 to year_10 = the allowance for each year of service, created_at, updated_at). All of them are returned in one reply. GET /holiday_allowances.
• breathehr_list_leave_requests ~368 tokens
  List leave requests (pending, approved, rejected and cancelling requests) with employee, dates, half days, type, status and notes. Filter by employee, department and start-date range. GET /leave_requests.
• breathehr_list_locations ~74 tokens
  List the company's work locations (id, name). All of them are returned in one reply. GET /locations.
• breathehr_list_other_leave_reasons ~97 tokens
  List the reasons for non-holiday leave (e.g. compassionate, jury service). Use the ids to filter absences. All of them are returned in one reply. GET /other_leave_reasons.
• breathehr_list_salaries ~254 tokens
  List salary records (amount, basis, payment schedule, start date) for the whole company, one employee or one department. GET /salaries, /employees/{id}/salaries or /departments/{id}/salaries.
• breathehr_list_sicknesses ~346 tokens
  List sickness absence records (health data): employee, sickness type, dates, half days, days deducted, status (open, returned, closed…) and reason. Filter by employee, department and start-date range. GET /sicknesses.
• breathehr_list_training_courses ~200 tokens
  List employee training records (course name, type, status, dates, cost) for all employees or one employee. GET /employee_training_courses.
• breathehr_list_working_patterns ~88 tokens
  List the working patterns (hours per weekday, total weekly hours, default flag). All of them are returned in one reply. GET /working_patterns.
• breathehr_reject_leave_request ~191 tokens
  WRITE: reject a pending leave request with a reason the employee will see. Recorded as done by the "API Employee". POST /leave_requests/{id}/reject.

Related MCP servers

• Tamigo MCP by usefulapi
  Read Tamigo departments, employees, shifts, absences and opening hours; register attendance.
• Jet HR MCP by usefulapi
  Read Jet HR employees, absences, clockings, payroll; create, approve, delete leave; create expenses.
• RotaCloud MCP by usefulapi
  Read RotaCloud shifts, attendance, leave, availability and payroll; create shifts and handle leave.
• Papershift MCP by usefulapi
  Read Papershift absences, vacation, time tracking and shifts; request and review absences.
• Shiftbase MCP by usefulapi
  Read Shiftbase rosters, timesheets, absences and availability; schedule shifts and review absences.
• PaySpace MCP by usefulapi
  Read PaySpace employees, organization, payroll runs, payslips and leave records. Read-only.
• kiwiHR MCP by usefulapi
  Read kiwiHR employees, time off, timesheets, projects; create and update employees, timesheets.
• Deputy MCP by usefulapi
  See rosters, timesheets, leave and staff in Deputy, and create shifts, leave and memos.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/breathe-hr.svg)](https://aptlynx.net/servers/io.usefulapi/breathe-hr)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents