FoyerDevelopers

Generated · Live registry

tasks tools

19 tools in this domain, generated from the running registry. 1 of them do not declare a response schema; that is stated on each one rather than guessed at.

All tool domains

tasks.addComment

writes

Replies to a task. Mutation — changes data.

Input parameters

FieldTypeRequiredNotes
taskIdstringyes
textstringyes

Output fields

FieldTypeRequiredNotes
okbooleanyes

tasks.add_photo

writes

Attach a photo (image/jpeg, image/png, image/webp) to a task as completion evidence. Body is base64-encoded. Stored under the tenant's photo bucket; URL returned for embedding in chat. Max 5 MB per photo.

Input parameters

FieldTypeRequiredNotes
taskIdstringyes
mimeTypeenumyesOne of: image/jpeg, image/png, image/webp
bytesBase64stringyes

Output fields

FieldTypeRequiredNotes
urlstringyes

tasks.assign

writesconfirm

Reassign a task to a different worker (or unassign by passing null). Mutating action — the MCP client must include _confirm: true.

Input parameters

FieldTypeRequiredNotes
idstringyes
userIdstring · nullableyes

Output fields

FieldTypeRequiredNotes
okliteralyesOne of: true

tasks.byId

read-only

Returns a task (id) with event history and attachments. Work roles see only their own tasks; an unknown or invisible id yields null instead of an error. Any signed-in role. Read-only.

Input parameters

FieldTypeRequiredNotes
idstringyes

Output fields

The whole object may be null.

FieldTypeRequiredNotes
idstringyes
tenantIdstringyes
conversationIdstring · nullableyes
messageIdstring · nullableyes
stayIdstring · nullableyes
roomstring · nullableyes
assignedToUserIdstring · nullableyes
kindenumyesOne of: cleaning, maintenance, delivery, other
titlestringyes
descriptionstring · nullableyes
priorityenumyesOne of: low, normal, high, urgent
statusenumyesOne of: open, assigned, in_progress, done, cancelled
aiGeneratedbooleanyes
aiConfidencestring · nullableyesDecimal as string — numeric column, not an IEEE-754 double
summaryTranslationsobjectyes
dueAtstring · nullableyes
createdByUserIdstring · nullableyes
createdAtstringyes
updatedAtstringyes
completedAtstring · nullableyes
eventsarray of objectyes
events.idstringyes
events.taskIdstringyes
events.kindenumyesOne of: created, assigned, status_changed, comment, photo_added, reassigned
events.actorUserIdstring · nullableyes
events.createdAtstringyes
attachmentsarray of objectyes
attachments.idstringyes
attachments.taskIdstringyes
attachments.kindenumyesOne of: photo, document, guest_photo
attachments.urlstringyes
attachments.mimeTypestring · nullableyes
attachments.sizeBytesinteger · nullableyes
attachments.uploadedByUserIdstring · nullableyes
attachments.createdAtstringyes

tasks.calendarGrid

read-only

Hospitable-style 2D calendar feed: rooms × dates with task pills. UI consumer: /operations/calendar/tasks (Phase 5). Two RLS-scoped SELECTs (rooms, tasks-in-range). Caller buckets by (room.name, dueAt) since `tasks.room` is varchar, not a FK. Read-only query.

Input parameters

FieldTypeRequiredNotes
fromstringyes
tostringyes
roomIdsarray of stringno

Output fields

FieldTypeRequiredNotes
roomsarray of objectyes
rooms.idstringyes
rooms.namestringyes
tasksarray of objectyes
tasks.idstringyes
tasks.titlestringyes
tasks.roomstring · nullableyes
tasks.kindenumyesOne of: cleaning, maintenance, delivery, other
tasks.statusenumyesOne of: open, assigned, in_progress, done, cancelled
tasks.priorityenumyesOne of: low, normal, high, urgent
tasks.dueAtstring · nullableyes
tasks.assignedToUserIdstring · nullableyes
fromstringyes
tostringyes

tasks.comments

read-only

Reads a task's thread: the return channel to the damage report. The cleaner reports via their link (`reinigung.meldeSchaden`); without these two procedures there would be no reply, only a filing. Read-only query.

Input parameters

FieldTypeRequiredNotes
taskIdstringyes

Output fields

Returns array of object. Fields of each element:

FieldTypeRequiredNotes
idstringyes
textstringyes
vonstring · nullableyes
eigenerbooleanyes
createdAtanyyes

tasks.counts

read-only

Dashboard tab counts. RLS scopes to current tenant. Buckets: - needsAction: unassigned & open - inProgress: assigned or in_progress - upcoming: open/assigned/in_progress with due_at in next 7d - past: done/cancelled OR overdue active rows. Read-only query.

Input parameters

Returns object.

Output fields

FieldTypeRequiredNotes
needsActionintegeryes
inProgressintegeryes
upcomingintegeryes
pastintegeryes

tasks.create

writes

Create a manual task. Mirrors the operator UI's manual-create form. If assignedToUserId is set, status starts at 'assigned'; otherwise 'open'. Optional dueAt (ISO timestamp with time zone, e.g. 2026-10-21T16:00:00+02:00) sets the due date; without it the task has none and shows under „Heute“ until done.

Input parameters

FieldTypeRequiredNotes
kindenumyesOne of: cleaning, maintenance, delivery, other
titlestringyes
descriptionstringno
priorityenumnoOne of: low, normal, high, urgent — Default: "normal"
roomstringno
assignedToUserIdstringno
dueAtstringno

Output fields

FieldTypeRequiredNotes
idstringyes

tasks.get

read-only

Get a single task with its full event timeline and photo/document attachments. Returns null if the task doesn't exist or isn't visible to the key (housekeeping/maintenance-scoped keys see no tasks — keys have no user).

Input parameters

FieldTypeRequiredNotes
idstringyes

Output fields

The whole object may be null.

FieldTypeRequiredNotes
taskobjectyes
task.idstringyes
task.kindenumyesOne of: cleaning, maintenance, delivery, other
task.titlestringyes
task.descriptionstring · nullableyes
task.priorityenumyesOne of: low, normal, high, urgent
task.statusenumyesOne of: open, assigned, in_progress, done, cancelled
task.roomstring · nullableyes
task.assignedToUserIdstring · nullableyes
task.aiGeneratedbooleanyes
task.conversationIdstring · nullableyes
task.messageIdstring · nullableyes
task.stayIdstring · nullableyes
task.createdAtstringyes
task.updatedAtstringyes
task.completedAtstring · nullableyes
eventsarray of objectyes
events.idstringyes
events.kindstringyes
events.actorUserIdstring · nullableyes
events.payloadanyyes
events.createdAtstringyes
attachmentsarray of objectyes
attachments.idstringyes
attachments.kindstringyes
attachments.urlstringyes
attachments.mimeTypestring · nullableyes
attachments.sizeBytesnumber · nullableyes
attachments.uploadedByUserIdstring · nullableyes
attachments.createdAtstringyes

tasks.historySearch

read-only

Cross-stay history search. Matches the query against task titles, stay external_code (e.g. Hospitable confirmation code "HM54KEHW5X"), and stay external_ref. Returns the matched tasks plus any task_rule_executions rows linked to those tasks. Default window is the last 90 days. Read-only query.

Input parameters

FieldTypeRequiredNotes
qstringyes
dateFromstringno
dateTostringno
pageintegernoDefault: 1
pageSizeintegernoDefault: 25

Output fields

FieldTypeRequiredNotes
tasksarray of objectyes
tasks.idstringyes
tasks.titlestringyes
tasks.kindenumyesOne of: cleaning, maintenance, delivery, other
tasks.statusenumyesOne of: open, assigned, in_progress, done, cancelled
tasks.dueAtstring · nullableyes
tasks.completedAtstring · nullableyes
tasks.createdAtstringyes
tasks.roomstring · nullableyes
tasks.stayExternalCodestring · nullableyes
tasks.stayExternalRefstring · nullableyes
executionsarray of objectyes
executions.idstringyes
executions.ruleIdstringyes
executions.ruleNamestring · nullableyes
executions.triggeredAtstringyes
executions.outcomeenumyesOne of: task_created, condition_false, no_assignee, rule_disabled_during_eval, error
executions.taskIdstring · nullableyes
pageintegeryes
hasMorebooleanyes

tasks.listFiltered

read-only

List tasks filtered by status, date, assignee, or kind.

Input parameters

FieldTypeRequiredNotes
bucketenumyesOne of: needsAction, inProgress, upcoming, past
filtersobjectnoDefault: {}
filters.roomstringno
filters.assigneeUserIdstring | literalno
filters.kindenumnoOne of: cleaning, maintenance, delivery, other
filters.searchstringno
pageintegernoDefault: 1
pageSizeintegernoDefault: 25
sortenumnoOne of: dueAt, createdAt, priority — Default: "dueAt"
mitFotosbooleannoDefault: false

Output fields

FieldTypeRequiredNotes
rowsarray of objectyes
rows.idstringyes
rows.tenantIdstringyes
rows.conversationIdstring · nullableyes
rows.messageIdstring · nullableyes
rows.stayIdstring · nullableyes
rows.roomstring · nullableyes
rows.assignedToUserIdstring · nullableyes
rows.kindenumyesOne of: cleaning, maintenance, delivery, other
rows.titlestringyes
rows.descriptionstring · nullableyes
rows.priorityenumyesOne of: low, normal, high, urgent
rows.statusenumyesOne of: open, assigned, in_progress, done, cancelled
rows.aiGeneratedbooleanyes
rows.aiConfidencestring · nullableyesDecimal as string — numeric column, not an IEEE-754 double
rows.summaryTranslationsobjectyes
rows.dueAtstring · nullableyes
rows.createdByUserIdstring · nullableyes
rows.createdAtstringyes
rows.updatedAtstringyes
rows.completedAtstring · nullableyes
rows.fotosarray of objectno
pageintegeryes
hasMorebooleanyes

tasks.listForMe

read-only

List tasks assigned to the current (owner) user.

Input parameters

FieldTypeRequiredNotes
statusarray of enumno
ansichtenumnoOne of: heute

Output fields

Returns array of object. Fields of each element:

FieldTypeRequiredNotes
idstringyes
tenantIdstringyes
conversationIdstring · nullableyes
messageIdstring · nullableyes
stayIdstring · nullableyes
roomstring · nullableyes
assignedToUserIdstring · nullableyes
kindenumyesOne of: cleaning, maintenance, delivery, other
titlestringyes
descriptionstring · nullableyes
priorityenumyesOne of: low, normal, high, urgent
statusenumyesOne of: open, assigned, in_progress, done, cancelled
aiGeneratedbooleanyes
aiConfidencestring · nullableyesDecimal as string — numeric column, not an IEEE-754 double
summaryTranslationsobjectyes
dueAtstring · nullableyes
createdByUserIdstring · nullableyes
createdAtstringyes
updatedAtstringyes
completedAtstring · nullableyes

tasks.list_assignable_users

read-only

List tenant members in the housekeeping or maintenance pools — used as context when picking an assignee for a new task. Read-only.

Input parameters

Returns object.

Output fields

FieldTypeRequiredNotes
usersarray of objectyes
users.idstringyes
users.namestring · nullableyes
users.roleenumyesOne of: owner, staff, reception, housekeeping, maintenance
users.localestringyes

tasks.list_open

read-only

List tasks not yet completed (open + assigned + in_progress) across the tenant. Newest-first. Read-only.

Input parameters

Returns object.

Output fields

FieldTypeRequiredNotes
itemsarray of objectyes
items.idstringyes
items.kindenumyesOne of: cleaning, maintenance, delivery, other
items.titlestringyes
items.descriptionstring · nullableyes
items.priorityenumyesOne of: low, normal, high, urgent
items.statusenumyesOne of: open, assigned, in_progress, done, cancelled
items.roomstring · nullableyes
items.assignedToUserIdstring · nullableyes
items.aiGeneratedbooleanyes
items.conversationIdstring · nullableyes
items.messageIdstring · nullableyes
items.stayIdstring · nullableyes
items.createdAtstringyes
items.updatedAtstringyes
items.completedAtstring · nullableyes

tasks.list_unassigned

read-only

List open tasks that have no assignee yet. The operator's triage view: what's hanging in the queue. Newest-first. Read-only.

Input parameters

Returns object.

Output fields

FieldTypeRequiredNotes
itemsarray of objectyes
items.idstringyes
items.kindenumyesOne of: cleaning, maintenance, delivery, other
items.titlestringyes
items.descriptionstring · nullableyes
items.priorityenumyesOne of: low, normal, high, urgent
items.statusenumyesOne of: open, assigned, in_progress, done, cancelled
items.roomstring · nullableyes
items.assignedToUserIdstring · nullableyes
items.aiGeneratedbooleanyes
items.conversationIdstring · nullableyes
items.messageIdstring · nullableyes
items.stayIdstring · nullableyes
items.createdAtstringyes
items.updatedAtstringyes
items.completedAtstring · nullableyes

tasks.mark_done

writes

Mark a task as done. Sets status='done', completed_at=now, emits the task.completed webhook.

Input parameters

FieldTypeRequiredNotes
idstringyes

Output fields

FieldTypeRequiredNotes
okliteralyesOne of: true

tasks.reassign

writesconfirm

Reassign a task to a different worker. Pass userId=null to move it back to the unassigned pool. Equivalent to tasks.assign — exposed as a separate tool so prompts like 'reassign X to Y' resolve naturally. Mutating action — requires _confirm: true.

Input parameters

FieldTypeRequiredNotes
idstringyes
userIdstring · nullableyes

Output fields

FieldTypeRequiredNotes
okliteralyesOne of: true

tasks.setzeFaelligkeit

writes

Sets or removes the due date of a task (id). `dueAt` is an ISO timestamp with time zone, or `null` (no due date). Operator roles only; the change is recorded in the audit log (`task.faelligkeit_gesetzt`) with old and new value. Mutation — changes data.

Input parameters

FieldTypeRequiredNotes
idstringyes
dueAtstring · nullableyes

Output fields

FieldTypeRequiredNotes
idstringyes
dueAtstring · nullableyes

tasks.updateStatus

writes

Change a task's status (open / in progress / done / etc.).

Input parameters

FieldTypeRequiredNotes
idstringyes
statusenumyesOne of: in_progress, done, cancelled

Output fields

Response shape not declared.