List task lists
Task lists and their tasks from the Onboarding or Offboarding settings.
MCP tool bamboohr_read → list_task_lists
read
Returns every list from the Onboarding or Offboarding settings with its tasks, including the Miscellaneous Tasks list BambooHR keeps for tasks without a list. Each task shows its default assignee, when the filters apply and the notification timing set for it. Use list_id in add_task_lists. Reads settings only and changes nothing.
Parameters
| Name | Type | Description |
|---|---|---|
| kind string required | string | Which checklist: 'onboarding' or 'offboarding'. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "bamboohr_read",
"arguments": {
"operation": "list_task_lists",
"arguments": {
"kind": "kind"
}
}
}
} Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"kind": "onboarding",
"lists": [
{
"list_id": "tl_it_setup",
"name": "IT setup",
"tasks": [
{
"task": "Order laptop",
"assignee": "Priya Shah",
"notify": "on due date"
},
{
"task": "Create accounts",
"assignee": "Priya Shah",
"notify": "a day before due date"
}
]
},
{
"list_id": "tl_manager",
"name": "Manager tasks",
"tasks": [
{
"task": "Schedule first-week 1:1",
"assignee": "Hiring manager",
"notify": "15 minutes after assigned"
}
]
},
{
"list_id": "tl_misc",
"name": "Miscellaneous Tasks",
"tasks": []
}
]
},
"isError": false
}