---
name: tracker/linear-official:cycle-read
description: Read Linear cycle (sprint equivalent) details
version: "0.5.0"
---

> **Backend:** linear-official (linear@claude-plugins-official)
> **Note:** Requires `linear@claude-plugins-official` plugin. Install: `/plugin install linear@claude-plugins-official`
> **Tool names are provisional.** Exact MCP tool names will be confirmed when the Linear plugin is available. Update this file after enabling the plugin and running tool discovery.

# Linear Cycle Read

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| cycle_id | string | Conditional | Internal Linear UUID for the cycle (required if team_id + cycle_number not provided) |
| team_id | string | Conditional | Team ID to scope the lookup (required if using cycle_number) |
| cycle_number | integer | Conditional | Sequential cycle number within the team (required if using team_id instead of cycle_id) |

## Implementation

Uses `mcp__linear__getCycles` (TBD). Fetches cycle details including date boundaries, associated issues, overall progress percentage, and scope-change history. Cycles are Linear's equivalent of sprints — time-boxed iterations within a team.

## Output

| Field | Type | Description |
|-------|------|-------------|
| cycle | object | Cycle object including id, number, name, start_date, end_date, and progress_percentage |
| cycle.issues | array | Issues in the cycle with their current states |
| cycle.scope_changes | array | History of issues added or removed after the cycle started |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| CYCLE_NOT_FOUND | No cycle matches the provided cycle_id or team_id + cycle_number combination | Verify identifiers or list cycles for the team |
| AUTH_FAILED | Plugin is missing, not installed, or lacks read permission | Run `/plugin install linear@claude-plugins-official` and verify plugin auth |

## Used By

- dev-sprint
