---
title: "Linear integration for LuumenAI"
url: "https://www.luumen.ai/integrations/linear/"
entity: SoftwareIntegration
category: "Project management"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Linear integration for LuumenAI

Fast follow-ups filed with the run linked.

## What LuumenAI can do with Linear

LuumenAI connects to Linear with an API token and exposes 47 tools (22 read-only · 21 write · 4 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 47 tools (22 read-only · 21 write · 4 destructive)
- Plan: available on all plans
- Category: Project management

## About Linear with LuumenAI

Keep Linear in sync with operational work. LuumenAI finds related issues, files follow-ups with the run linked, and updates status — every write previewed and approved first.

## Example tools

Read-only (22 in total):

- `LINEAR_GET_ATTACHMENT` — Downloads a Linear Attachment record or a private upload embedded in issue/comment Markdown; `file_name` must include the correct extension.
- `LINEAR_GET_COMMENT` — Retrieves a single Linear comment by its unique ID.
- `LINEAR_GET_CURRENT_USER` — Gets the currently authenticated user's ID, name, email, and other profile information — this is the account behind the API token, which may be a bot or service account rather than a human user.
- `LINEAR_GET_CYCLES_BY_TEAM_ID` — Retrieves all cycles for a specified Linear team ID; cycles are time-boxed work periods (like sprints).
- `LINEAR_GET_ISSUE_DEFAULTS` — Fetches a Linear team's default issue estimate and state, useful for pre-filling new issue forms.
- `LINEAR_GET_LINEAR_ISSUE` — Retrieves an existing Linear issue's comprehensive details, including id, identifier, title, description, timestamps, state, team, creator, attachments, comments (with user info and timestamps, use…
- `LINEAR_GET_LINEAR_PROJECT` — Retrieves a single Linear project by its unique identifier.
- `LINEAR_GET_PROJECT_UPDATE` — Retrieves a specific project update by its unique identifier.

Write and destructive (25 in total, approval required by default):

- `LINEAR_ARCHIVE_ISSUE` — Archives an existing Linear issue by its ID, removing it from active views while preserving its data for future reference.
- `LINEAR_ARCHIVE_PROJECT` — Archives an existing Linear project by its UUID, removing it from active views.
- `LINEAR_ARCHIVE_PROJECT_UPDATE` — Archives a project update in Linear, hiding it from the default view while preserving its data.
- `LINEAR_CREATE_ATTACHMENT` — Creates a new attachment and associates it with a specific, existing Linear issue.
- `LINEAR_CREATE_COMMENT_REACTION` — Add a reaction to an existing Linear comment.
- `LINEAR_CREATE_LINEAR_COMMENT` — Creates a new comment on a specified Linear issue.
- `LINEAR_CREATE_LINEAR_ISSUE` — Creates a new issue in a specified Linear project and team, requiring team_id and title, and allowing optional properties like description, assignee, state, priority, cycle, and due date.
- `LINEAR_CREATE_LINEAR_ISSUE_RELATION` — Create a relationship between two Linear issues using the issueRelationCreate mutation.

## Frequently asked questions

### How does LuumenAI connect to Linear?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Linear on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 4 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Linear — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/linear/