BrightHR MCP by usefulapi
Read employees, clock-ins and absences; set employee external references in BrightHR.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (1)
- LOWin brighthr_set_employee_external_reference
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"brighthr": {
"url": "https://brighthr.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://brighthr.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (4)
🟢brighthr_list_employees(email, externalReference, isTerminated, pageSize, continuationToken)
List the employees of your BrightHR organisation with name, job title, start and end dates, email, external reference and registration/termination status. Filter by email, external reference or termination status. Paginated: pass the returned continuationToken to get the next page. BrightHR Customer API: POST /employees/v1/query.
Eingabe-Schema
{
"type": "object",
"properties": {
"email": {
"description": "Only employees with this email address.",
"type": "string"
},
"externalReference": {
"description": "Only employees with this external reference.",
"type": "string"
},
"isTerminated": {
"description": "true for leavers only, false for current employees only.",
"type": "boolean"
},
"pageSize": {
"description": "Items per page (1-100, default 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"continuationToken": {
"description": "continuationToken from the previous response; omit for the first page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴brighthr_set_employee_external_reference(employeeId, externalReference)
WRITE: set or clear the external reference of one employee (1-36 characters; several employees may share one). Use it to link a BrightHR employee to an id in another system. Replaces any existing value. Pass null to clear it. BrightHR Customer API: PUT /employees/v1/{employeeId}/external-reference.
Eingabe-Schema
{
"type": "object",
"properties": {
"employeeId": {
"type": "string",
"minLength": 1,
"description": "The BrightHR employee id (from brighthr_list_employees)."
},
"externalReference": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 36
},
{
"type": "null"
}
],
"description": "The new external reference (1-36 characters), or null to clear it."
}
},
"required": [
"employeeId",
"externalReference"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢brighthr_list_clockings(employeeId, from, to, pageSize, continuationToken)
List Blip clock-in records of one employee: clock-in and clock-out times with time zones, breaks and notes, within an optional date range. Paginated with continuationToken. BrightHR Customer API: POST /blip/v1/clockings/query.
Eingabe-Schema
{
"type": "object",
"properties": {
"employeeId": {
"type": "string",
"minLength": 1,
"description": "The BrightHR employee id (from brighthr_list_employees)."
},
"from": {
"description": "Start or end of the range, as the API's date or date-time string (for example 2026-01-31).",
"type": "string"
},
"to": {
"description": "Start or end of the range, as the API's date or date-time string (for example 2026-01-31).",
"type": "string"
},
"pageSize": {
"description": "Items per page (1-100, default 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"continuationToken": {
"description": "continuationToken from the previous response; omit for the first page.",
"type": "string"
}
},
"required": [
"employeeId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢brighthr_list_absences(employeeId, from, to, pageSize, continuationToken)
List approved absences of one employee within an optional date range: holiday, sickness, time off in lieu (TOIL) and other. Lateness is not included. Each item has a $type field. Paginated with continuationToken. BrightHR Customer API: POST /absences/v1/query.
Eingabe-Schema
{
"type": "object",
"properties": {
"employeeId": {
"type": "string",
"minLength": 1,
"description": "The BrightHR employee id (from brighthr_list_employees)."
},
"from": {
"description": "Start or end of the range, as the API's date or date-time string (for example 2026-01-31).",
"type": "string"
},
"to": {
"description": "Start or end of the range, as the API's date or date-time string (for example 2026-01-31).",
"type": "string"
},
"pageSize": {
"description": "Items per page (1-100, default 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"continuationToken": {
"description": "continuationToken from the previous response; omit for the first page.",
"type": "string"
}
},
"required": [
"employeeId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis