# Get Task

`lawmatics_get-task` · Lawmatics MCP tool · Tasks

Fetch a single task from Lawmatics by ID, including a `relationships` envelope of {id,type} pointers to related records (the associated matter/contact/company via `taskable`, assigned users, documents, files, subtasks, and comments).

## Input

- **taskId** `string` (required, pattern: ^\d+$) — ID of the task to fetch; a numeric string

## Output

- **id** `string` (required) — Unique ID of the task
- **name** `string` (required) — Name/title of the task
- **description** `string | null` (required) — Description of the task; null if unset
- **dueDate** `string | null` (required) — ISO 8601 timestamp the task is due; null if no due date is set
- **done** `boolean` (required) — Whether the task is completed
- **status** `string | null` (required) — Read-only display status (e.g. "No Status"); null when the projection omits it
- **priority** `string` (required) — Task priority as returned by the API (high, medium, low)
- **tags** `array` (required) — Tags attached to this task
  - **[]** `object`
    - **id** `string` (required) — Unique ID of the tag
    - **name** `string` (required) — Name of the tag
    - **color** `string | null` (required) — Hex display color of the tag; null if unset
- **assignedById** `string | null` (required) — ID of the firm user who assigned the task; null if unset or omitted
- **recurrenceRule** `object | null` (required) — Recurrence rule with inner keys preserved exactly as the API returns them (type, frequency, weekday booleans, and an end-date key that may appear as endDate or end_date); null when the task does not recur
  - **[key: string]** `string | number | boolean | null`
- **createdAt** `string | null` (required) — When the task was created, as an ISO 8601 timestamp; null if unknown
- **updatedAt** `string | null` (required) — When the task was last updated, as an ISO 8601 timestamp; null if unknown
- **relationships** `object` (required) — JSON:API relationship pointers to related records as {id,type} stubs. Not materialized — follow a pointer by calling that resource's own get/find tool (e.g. type 'prospect' -> get-matter, type 'contact' -> get-contact, type 'user' -> get-user).
  - **taskable** `object | null` (required) — Associated record (matter/prospect, contact, or company) pointer; null for unattached tasks
    - **id** `string` (required) — ID of the referenced Lawmatics record
    - **type** `string` (required) — JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
  - **users** `array` (required) — Assigned firm-user pointers (type 'user'); empty if none
    - **[]** `object`
      - **id** `string` (required) — ID of the referenced Lawmatics record
      - **type** `string` (required) — JSON:API record class of the reference; resolve it by calling that resource's own tool
  - **documents** `array` (required) — Document pointers; empty if none
    - **[]** `object`
      - **id** `string` (required) — ID of the referenced Lawmatics record
      - **type** `string` (required) — JSON:API record class of the reference; resolve it by calling that resource's own tool
  - **files** `array` (required) — File pointers; empty if none
    - **[]** `object`
      - **id** `string` (required) — ID of the referenced Lawmatics record
      - **type** `string` (required) — JSON:API record class of the reference; resolve it by calling that resource's own tool
  - **subtasks** `array` (required) — Subtask pointers; empty if none
    - **[]** `object`
      - **id** `string` (required) — ID of the referenced Lawmatics record
      - **type** `string` (required) — JSON:API record class of the reference; resolve it by calling that resource's own tool
  - **comments** `array` (required) — Comment pointers; empty if none
    - **[]** `object`
      - **id** `string` (required) — ID of the referenced Lawmatics record
      - **type** `string` (required) — JSON:API record class of the reference; resolve it by calling that resource's own tool