> ## Documentation Index
> Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# task_get

> MCP tool that retrieves a single task from an agent's checklist by ID — full subject, description, status, dependencies, and history.

Gets a single task by ID from an [agent's](/concepts/agents) checklist. Returns the full task object including subject, description, status, and dependency edges.

Equivalent to [`murmur task get`](/cli/task-get) in the CLI.

## Parameters

| Name        | Type   | Required | Description                                                                                                                     |
| ----------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `task_id`   | string | yes      | ID of the task to retrieve.                                                                                                     |
| `slug`      | string | no       | Agent slug. Empty means self. Use an absolute path like `/w/workspace/u/account/slug` to target an agent outside your own path. |
| `workspace` | string | no       | Workspace name. Overrides the session default.                                                                                  |

## Response

Returns a single task object.

| Field         | Type      | Description                                                                                                    |
| ------------- | --------- | -------------------------------------------------------------------------------------------------------------- |
| `taskId`      | string    | The task's unique ID.                                                                                          |
| `subject`     | string    | Short summary of the task.                                                                                     |
| `description` | string    | Detailed task description.                                                                                     |
| `status`      | string    | Task status: `TASK_STATUS_PENDING`, `TASK_STATUS_IN_PROGRESS`, `TASK_STATUS_COMPLETED`, `TASK_STATUS_DELETED`. |
| `blocks`      | string\[] | Task IDs that this task blocks.                                                                                |
| `blockedBy`   | string\[] | Task IDs that block this task.                                                                                 |
| `activation`  | object    | Conditional activation config, if set.                                                                         |

## Examples

### Get a task

```json theme={null}
{
  "task_id": "t_abc123"
}
```

Response:

```json theme={null}
{
  "taskId": "t_abc123",
  "subject": "Add pagination to the users API",
  "description": "Use cursor-based pagination with a default page size of 50.",
  "status": "TASK_STATUS_IN_PROGRESS",
  "blocks": ["t_def456"]
}
```

### Get a task from another agent

```json theme={null}
{
  "task_id": "t_abc123",
  "slug": "fix-auth"
}
```

## Errors

| Code              | Meaning                               | What to do                                                                                      |
| ----------------- | ------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `NOT_FOUND`       | Task or agent not found.              | Check the `task_id` and `slug`. Use [`task_list`](/mcp-server/task-list) to see existing tasks. |
| `UNAUTHENTICATED` | Identity token is missing or expired. | Check credentials.                                                                              |

## Related

* [`murmur task get`](/cli/task-get) — equivalent CLI command
* [`task_create`](/mcp-server/task-create) — create a new task
* [`task_update`](/mcp-server/task-update) — update a task
* [`task_list`](/mcp-server/task-list) — list all tasks