---
name: tracker/linear-official:project-read
description: Read Linear project details and progress
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 Project Read

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| project_id | string | Yes | Internal Linear UUID for the project |

## Implementation

Uses `mcp__linear__getProject` (TBD). Fetches project details including metadata, milestone list, and a breakdown of issue counts by state. Progress percentage is calculated from completed issues divided by total issues.

## Output

| Field | Type | Description |
|-------|------|-------------|
| project | object | Project object including id, name, description, status, lead, target_date, url, and progress stats |
| project.total_issues | integer | Total issue count in the project |
| project.completed_issues | integer | Count of issues in a completed state |
| project.in_progress_issues | integer | Count of issues currently in progress |
| project.backlog_issues | integer | Count of issues not yet started |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| PROJECT_NOT_FOUND | No project matches the provided project_id | Verify the project_id or search for the project in Linear |
| 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
- deploy-status
