Linear

Add a comment to an issue.

Add a comment to a project's document content. IMPORTANT: Due to Linear API limitations, comments created via the API will NOT appear visually anchored inline in the document (no yellow highlight on text). The comment will be stored and can be retrieved via list_project_comments, but it will appear in the comments panel rather than inline in the document. For true inline comments that are visually anchored to text, users should create them directly in the Linear UI by selecting text and adding a comment. The quoted_text parameter stores metadata about what text the comment references, which is useful for context even though the comment won't be visually anchored.

Link a project to an initiative. Both initiative and project can be specified by ID or name. If a name is provided, fuzzy matching is used to resolve it.

Archive an initiative. Archived initiatives are hidden from default views but can be restored.

Archive an issue. Archived issues are hidden from default views but can be restored.

Archive a project. Archived projects are hidden from default views but can be restored.

Create a new Linear initiative. Initiatives are high-level strategic goals that group related projects.

Create a new Linear issue with validation. When assignee is None or '@me', the issue is assigned to the authenticated user. All entity references (team, assignee, labels, state, project, cycle, parent) are validated before creation. If an entity is not found, suggestions are returned to help correct the input.

Create a relation between two issues. Relation types define the relationship from the source issue's perspective: - blocks: Source issue blocks the related issue - blockedBy: Source issue is blocked by the related issue - duplicate: Source issue is a duplicate of the related issue - related: Issues are related (bidirectional)

Create a new Linear project. Team is validated before creation. If team is not found, suggestions are returned to help correct the input. Lead is validated if provided.

Create a project status update. Project updates are posts that communicate progress, blockers, or status changes to stakeholders. They appear in the project's Updates tab and can include a health status indicator.

Get detailed information about a specific Linear cycle.

Get detailed information about a specific Linear initiative. Supports lookup by ID or name (with fuzzy matching for name).

Get an initiative's full description with pagination support. Use this tool when you need the complete description of an initiative that was truncated in the get_initiative response. Supports chunked reading for very large descriptions.

Get detailed information about a specific Linear issue. Accepts either the issue UUID or the human-readable identifier (like TOO-123).

Get the authenticated user's notifications. Returns notifications including issue mentions, comments, assignments, and state changes.

Get detailed information about a specific Linear project. Supports lookup by ID, slug_id, or name (with fuzzy matching for name).

Get a project's full description with pagination support. Use this tool when you need the complete description of a project that was truncated in the get_project response. Supports chunked reading for very large descriptions.

Get the authenticated user's recent issue activity. Returns issues the user has recently created or been assigned to within the specified time period.

Get detailed information about a specific Linear team. Supports lookup by ID, key (like TOO, ENG), or name (with fuzzy matching).

Link a GitHub PR, commit, or issue to a Linear issue. Automatically detects the artifact type from the URL and generates an appropriate title if not provided.

List comments on an issue. Returns comments with user info, timestamps, and reply threading info.

List Linear cycles, optionally filtered by team and status. Cycles are time-boxed iterations (like sprints) for organizing work.

List Linear initiatives, optionally filtered by keywords and other criteria. Returns all initiatives when no filters provided, or filtered results when keywords or other filters are specified.

List Linear issues, optionally filtered by keywords and other criteria. Returns all issues when no filters provided, or filtered results when keywords or other filters are specified.

List available issue labels in the workspace. Returns labels that can be applied to issues. Use label IDs or names when creating or updating issues.

List comments on a project's document content. Returns comments with user info, timestamps, quoted text for inline comments, and reply threading info. Replies are nested under their parent comments. Use comment_filter to control which comments are returned: - only_quoted (default): Only comments attached to a quote in the text - only_unquoted: Only comments not attached to a particular quote - all: All comments regardless of being attached to a quote or not

List Linear projects, optionally filtered by keywords and other criteria. Returns all projects when no filters provided, or filtered results when keywords or other filters are specified.

List Linear teams, optionally filtered by keywords and other criteria. Returns all teams when no filters provided, or filtered results when keywords or other filters are specified.

List available workflow states in the workspace. Returns workflow states that can be used for issue transitions. States are team-specific and have different types.

Subscribe to or unsubscribe from an issue's notifications.

Reply to an existing comment on an issue. Creates a threaded reply to the specified parent comment.

Reply to an existing comment on a project document. Creates a threaded reply to the specified parent comment.

Transition a Linear issue to a new workflow state. The target state is validated against the team's available states.

Update an existing comment.

Update a Linear initiative with partial updates. Only fields that are explicitly provided will be updated.

Update a Linear issue with partial updates. Only fields that are explicitly provided will be updated. All entity references are validated before update.

Update a Linear project with partial updates. Only fields that are explicitly provided will be updated. All entity references are validated before update. IMPORTANT: Updating the 'content' field will break any existing inline comment anchoring. The comments will still exist and be retrievable via list_project_comments, but they will no longer appear visually anchored to text in the Linear UI. The 'description' field can be safely updated without affecting inline comments.

Get the authenticated user's profile and team memberships. Returns the current user's information including their name, email, organization, and the teams they belong to.