Servers Playground How we check Add a server Log in

Breathe HR MCP by usefulapi

Working · 703 ms

io.usefulapi/breathe-hrv1.9.3 Domain verified

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

Productivity

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

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

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

breathehr_approve_leave_request Destructive

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.

leave_request_idinteger, required

Breathe leave request id (from breathehr_list_leave_requests).

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Breathe HR MCP by usefulapi MCP server | mcptry

Tools (25)

breathehr_approve_leave_request

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.

destructive

Argument	Type	Description
leave_request_id*	integer	Breathe leave request id (from breathehr_list_leave_requests).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "leave_request_id"
  ],
  "properties": {
    "leave_request_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Breathe leave request id (from breathehr_list_leave_requests).",
      "exclusiveMinimum": 0
    }
  }
}

breathehr_create_leave_request

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.

destructive

Argument	Type	Description
type	string	Holiday (default) or OtherLeave.
notes	string	Notes for the approver.
end_date*	string	Last day of leave (yyyy-mm-dd), same as start_date for one day.
half_end	boolean	The last day is a half day (default false).
half_start	boolean	The first day is a half day (default false).
start_date*	string	First day of leave (yyyy-mm-dd).
employee_id*	integer	Breathe employee id.
half_end_am_pm	string	Which half of the last day: am or pm (with half_end).
half_start_am_pm	string	Which half of the first day: am or pm (with half_start).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "employee_id",
    "start_date",
    "end_date"
  ],
  "properties": {
    "type": {
      "enum": [
        "Holiday",
        "OtherLeave"
      ],
      "type": "string",
      "description": "Holiday (default) or OtherLeave."
    },
    "notes": {
      "type": "string",
      "maxLength": 2000,
      "description": "Notes for the approver."
    },
    "end_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Last day of leave (yyyy-mm-dd), same as start_date for one day."
    },
    "half_end": {
      "type": "boolean",
      "description": "The last day is a half day (default false)."
    },
    "half_start": {
      "type": "boolean",
      "description": "The first day is a half day (default false)."
    },
    "start_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "First day of leave (yyyy-mm-dd)."
    },
    "employee_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Breathe employee id.",
      "exclusiveMinimum": 0
    },
    "half_end_am_pm": {
      "enum": [
        "am",
        "pm"
      ],
      "type": "string",
      "description": "Which half of the last day: am or pm (with half_end)."
    },
    "half_start_am_pm": {
      "enum": [
        "am",
        "pm"
      ],
      "type": "string",
      "description": "Which half of the first day: am or pm (with half_start)."
    }
  }
}

breathehr_get_account

The Breathe HR account (company) this API key belongs to: id, name, domain and enabled modules. GET /account.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

breathehr_get_employee

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}.

read-only

Argument	Type	Description
employee_id*	integer	Breathe employee id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "employee_id"
  ],
  "properties": {
    "employee_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Breathe employee id.",
      "exclusiveMinimum": 0
    }
  }
}

breathehr_get_holiday_years

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.

read-only

Argument	Type	Description
for_date	string	Only the holiday year that includes this date (yyyy-mm-dd), e.g. today.
employee_id*	integer	Breathe employee id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "employee_id"
  ],
  "properties": {
    "for_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Only the holiday year that includes this date (yyyy-mm-dd), e.g. today."
    },
    "employee_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Breathe employee id.",
      "exclusiveMinimum": 0
    }
  }
}

breathehr_get_leave_request

One leave request by id, with its status. GET /leave_requests/{id}.

read-only

Argument	Type	Description
leave_request_id*	integer	Breathe leave request id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "leave_request_id"
  ],
  "properties": {
    "leave_request_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Breathe leave request id.",
      "exclusiveMinimum": 0
    }
  }
}

breathehr_list_absences

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
type	string	Holiday or OtherLeave.
end_date	string	Only absences up to this date (yyyy-mm-dd).
per_page	integer	Results per page, 1-100 (default 25).
start_date	string	Only absences on or after this date (yyyy-mm-dd).
employee_id	integer	Only this employee's absences.
department_id	integer	Only absences of employees in this department.
exclude_cancelled	boolean	Leave out cancelled absences.
other_leave_reason_id	integer

breathehr_list_benefits

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	Results per page, 1-100 (default 25).
employee_id	integer	Only this employee's records.
department_id	integer	Only records of employees in this department.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "employee_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only this employee's records.",
      "exclusiveMinimum": 0
    },
    "department_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only records of employees in this department.",
      "exclusiveMinimum": 0
    }
  }
}

breathehr_list_bonuses

List bonus records (amount, date, description) for the whole company, one employee or one department. GET /bonuses, /employees/{id}/bonuses or /departments/{id}/bonuses.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	Results per page, 1-100 (default 25).
employee_id	integer	Only this employee's records.
department_id	integer	Only records of employees in this department.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "employee_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only this employee's records.",
      "exclusiveMinimum": 0
    },
    "department_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only records of employees in this department.",
      "exclusiveMinimum": 0
    }
  }
}

breathehr_list_change_requests

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	Results per page, 1-100 (default 25).
employee_id	integer	Only this employee's change requests.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "employee_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only this employee's change requests.",
      "exclusiveMinimum": 0
    }
  }
}

breathehr_list_departments

List the company's departments (id, name). Use the ids to filter absences, leave, sickness and pay. GET /departments.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	Results per page, 1-100 (default 25).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    }
  }
}

breathehr_list_divisions

List the company's divisions (id, name). All of them are returned in one reply. GET /divisions.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

breathehr_list_employee_jobs

List job history records (job title, start/end dates, department, location) for all employees or one employee. GET /employee_jobs.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	Results per page, 1-100 (default 25).
employee_id	integer	Only this employee's jobs.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "employee_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only this employee's jobs.",
      "exclusiveMinimum": 0
    }
  }
}

breathehr_list_employees

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
filter	string	Only employees with this role: hr (HR managers), line_manager, either, or neither.
per_page	integer	Results per page, 1-100 (default 25).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "filter": {
      "enum": [
        "hr",
        "line_manager",
        "either",
        "neither"
      ],
      "type": "string",
      "description": "Only employees with this role: hr (HR managers), line_manager, either, or neither."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    }
  }
}

breathehr_list_expense_claims

List expense claims (employee, total, state, approver) filtered by employee and state. GET /employee_expense_claims.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
state	string	Only claims in this state.
per_page	integer	Results per page, 1-100 (default 25).
employee_id	integer	Only this employee's claims.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "state": {
      "enum": [
        "submitted",
        "approved",
        "completed",
        "rejected"
      ],
      "type": "string",
      "description": "Only claims in this state."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "employee_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only this employee's claims.",
      "exclusiveMinimum": 0
    }
  }
}

breathehr_list_expenses

List individual expense items (date, description, type, amount, VAT, project). By default only unclaimed items; set include_claimed to see all. GET /employee_expenses.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	Results per page, 1-100 (default 25).
employee_id	integer	Only this employee's expenses.
include_claimed	boolean	Also return expenses already part of a claim.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "employee_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only this employee's expenses.",
      "exclusiveMinimum": 0
    },
    "include_claimed": {
      "type": "boolean",
      "description": "Also return expenses already part of a claim."
    }
  }
}

breathehr_list_holiday_allowances

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

breathehr_list_leave_requests

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
end_date	string	Only requests starting on or before this date (yyyy-mm-dd).
per_page	integer	Results per page, 1-100 (default 25).
start_date	string	Only requests starting on or after this date (yyyy-mm-dd).
employee_id	integer	Only this employee's requests.
department_id	integer	Only requests of employees in this department.
exclude_cancelled	boolean	Leave out cancelled requests.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "end_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Only requests starting on or before this date (yyyy-mm-dd)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "start_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Only requests starting on or after this date (yyyy-mm-dd)."
    },
    "employee_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only this employee's requests.",
      "exclusiveMinimum": 0
    },
    "department_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only requests of employees in this department.",
      "exclusiveMinimum": 0
    },
    "exclude_cancelled": {
      "type": "boolean",
      "description": "Leave out cancelled requests."
    }
  }
}

breathehr_list_locations

List the company's work locations (id, name). All of them are returned in one reply. GET /locations.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

breathehr_list_other_leave_reasons

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

breathehr_list_salaries

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	Results per page, 1-100 (default 25).
employee_id	integer	Only this employee's records.
department_id	integer	Only records of employees in this department.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "employee_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only this employee's records.",
      "exclusiveMinimum": 0
    },
    "department_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only records of employees in this department.",
      "exclusiveMinimum": 0
    }
  }
}

breathehr_list_sicknesses

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
end_date	string	Only sickness starting on or before this date (yyyy-mm-dd).
per_page	integer	Results per page, 1-100 (default 25).
start_date	string	Only sickness starting on or after this date (yyyy-mm-dd).
employee_id	integer	Only this employee's sickness.
department_id	integer	Only sickness of employees in this department.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "end_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Only sickness starting on or before this date (yyyy-mm-dd)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "start_date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Only sickness starting on or after this date (yyyy-mm-dd)."
    },
    "employee_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only this employee's sickness.",
      "exclusiveMinimum": 0
    },
    "department_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only sickness of employees in this department.",
      "exclusiveMinimum": 0
    }
  }
}

breathehr_list_training_courses

List employee training records (course name, type, status, dates, cost) for all employees or one employee. GET /employee_training_courses.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	Results per page, 1-100 (default 25).
employee_id	integer	Only this employee's training.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "employee_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only this employee's training.",
      "exclusiveMinimum": 0
    }
  }
}

breathehr_list_working_patterns

List the working patterns (hours per weekday, total weekly hours, default flag). All of them are returned in one reply. GET /working_patterns.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

breathehr_reject_leave_request

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.

destructive

Argument	Type	Description
leave_request_id*	integer	Breathe leave request id (from breathehr_list_leave_requests).
rejection_reason*	string	Why the request is rejected (shown to the employee).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "leave_request_id",
    "rejection_reason"
  ],
  "properties": {
    "leave_request_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Breathe leave request id (from breathehr_list_leave_requests).",
      "exclusiveMinimum": 0
    },
    "rejection_reason": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "Why the request is rejected (shown to the employee)."
    }
  }
}