Shiftbrook MCP by usefulapi
Read shifts, people, leave and timesheets; add people and approve leave in Shiftbrook.
使うべきか
品質と安全性
検出事項(1)
- LOWshiftbrook_approve_leave_request 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"shiftbrook": {
"url": "https://shiftbrook.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://shiftbrook.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(14)
🟢shiftbrook_check_key
Check that the API key is valid. Returns the organisation name. Shiftbrook GET /api/v1/auth/test.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shiftbrook_list_people(limit, cursor, status)
List people in the organisation, with open invites. Use status to filter. Shiftbrook GET /api/v1/people.
入力スキーマ
{
"type": "object",
"properties": {
"limit": {
"description": "Page size, 1 to 100 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "nextCursor from the previous page.",
"type": "string"
},
"status": {
"description": "Filter by status, as the Shiftbrook API defines it.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shiftbrook_get_person(person_id)
Get one person by id. Shiftbrook GET /api/v1/people/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"person_id": {
"type": "string",
"minLength": 1,
"description": "The person id."
}
},
"required": [
"person_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴shiftbrook_create_person(name, email, role)
Add a person to the organisation. Shiftbrook sends that person an invite email. The invite token is not returned. Shiftbrook POST /api/v1/people.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Full name."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Email address for the invite."
},
"role": {
"type": "string",
"minLength": 1,
"description": "Role, as the Shiftbrook API defines it."
}
},
"required": [
"name",
"email",
"role"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shiftbrook_list_locations(limit, cursor)
List the organisation's locations (sites). Shiftbrook GET /api/v1/locations.
入力スキーマ
{
"type": "object",
"properties": {
"limit": {
"description": "Page size, 1 to 100 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "nextCursor from the previous page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shiftbrook_get_location(location_id)
Get one location by id. Shiftbrook GET /api/v1/locations/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"location_id": {
"type": "string",
"minLength": 1,
"description": "The location id."
}
},
"required": [
"location_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shiftbrook_list_shifts(from, to, status, limit, cursor)
List shifts in the rota, optionally between two dates. Draft shifts are not published. Shiftbrook GET /api/v1/shifts.
入力スキーマ
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date, yyyy-mm-dd."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date, yyyy-mm-dd."
},
"status": {
"description": "Filter by status, as the Shiftbrook API defines it.",
"type": "string"
},
"limit": {
"description": "Page size, 1 to 100 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "nextCursor from the previous page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shiftbrook_get_shift(shift_id)
Get one shift by id. Shiftbrook GET /api/v1/shifts/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"shift_id": {
"type": "string",
"minLength": 1,
"description": "The shift id."
}
},
"required": [
"shift_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shiftbrook_list_leave_requests(limit, cursor, status)
List leave requests. Use status to see only pending or approved requests. Shiftbrook GET /api/v1/leave-requests.
入力スキーマ
{
"type": "object",
"properties": {
"limit": {
"description": "Page size, 1 to 100 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "nextCursor from the previous page.",
"type": "string"
},
"status": {
"description": "Filter by status, as the Shiftbrook API defines it.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shiftbrook_get_leave_request(leave_request_id)
Get one leave request by id. Shiftbrook GET /api/v1/leave-requests/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"leave_request_id": {
"type": "string",
"minLength": 1,
"description": "The leave request id."
}
},
"required": [
"leave_request_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴shiftbrook_approve_leave_request(leave_request_id)
Approve one leave request. This changes the request and its approved absence. Shiftbrook POST /api/v1/leave-requests/{id}/approve.
入力スキーマ
{
"type": "object",
"properties": {
"leave_request_id": {
"type": "string",
"minLength": 1,
"description": "The leave request id."
}
},
"required": [
"leave_request_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shiftbrook_list_timesheets(limit, cursor, status)
List timesheets. With status 'approved', each item includes approvedHours. Shiftbrook GET /api/v1/timesheets.
入力スキーマ
{
"type": "object",
"properties": {
"limit": {
"description": "Page size, 1 to 100 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "nextCursor from the previous page.",
"type": "string"
},
"status": {
"description": "Filter by status, as the Shiftbrook API defines it.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shiftbrook_get_timesheet(timesheet_id)
Get one timesheet by id. Shiftbrook GET /api/v1/timesheets/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"timesheet_id": {
"type": "string",
"minLength": 1,
"description": "The timesheet id."
}
},
"required": [
"timesheet_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shiftbrook_list_absences(from, to)
List approved leave that overlaps a date range, for example one month. Shiftbrook GET /api/v1/absences.
入力スキーマ
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date, yyyy-mm-dd."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date, yyyy-mm-dd."
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス