Linear

Extract and fetch images from markdown content. Use this to view screenshots, diagrams, or other images embedded in Linear issues, comments, or documents. Pass the markdown content (e.g., issue description) and receive the images as viewable data.

extract_images

Fetch a Linear issue, project, initiative, or document by entity-prefixed ID. Use to get full details for results returned by the search tool. Also works with any known identifier.

fetch

Get shared field notes relevant to a task before starting work in an area of the codebase or product. Describe the task in a few sentences, including the feature area, integration, or files involved. Returns the full markdown of the most relevant notes documents. When none apply, it returns no documents and a note that the area has no notes yet; record what you verify there with record_agent_learning. Treat the notes as verified context from earlier work, and prefer the code when they disagree.

get_agent_context

Retrieve a Linear Agent skill by ID, including its full markdown instructions.

get_agent_skill

Retrieve an issue attachment by ID. Use format=url to get its title and download URL without fetching the file content. Linear upload URLs are signed for five minutes; call again to refresh. External URLs are returned unchanged. Files embedded in comments have no issue attachment ID; use the URLs in list_comments attachments instead. Download and process documents with your own file tools.

get_attachment

Exact lookup for a Linear diff. Use with review URLs, GitHub PR URLs, Linear full identifiers, UUIDs, or slugs.

get_diff

Exact lookup for diff threads and the authenticated user's drafts. Use with review URLs, GitHub PR URLs, Linear full identifiers, UUIDs, or slugs.

get_diff_threads

Retrieve a Linear document by ID or slug

get_document

Retrieve detailed information about a specific initiative in Linear

get_initiative

Retrieve detailed information about an issue by ID, including attachments, git branch name, and active Triage Intelligence suggestions when the issue is in triage. A nonempty fields selection overrides the include options; request optional fields directly in fields.

get_issue

Retrieve detailed information about an issue status in Linear by name or ID

get_issue_status

Retrieve details of a specific milestone by ID or name

get_milestone

Get a page of notifications from the authenticated user's Linear inbox.

get_notifications

Retrieve the profile of the currently authenticated user

get_profile

Retrieve details of a specific project in Linear

get_project

Retrieve details of a release by ID or slug.

get_release

Retrieve release notes by ID or slug, including markdown content.

get_release_note

List or get project/initiative status updates with their body, health, author, and parent project or initiative. Pass id to get one update and ignore list filters; omit id to list.

get_status_updates

Retrieve details of a specific Linear team, including its parent ID and hierarchy name. Use list_teams with parentTeam or ancestorTeam to find its sub-teams

get_team

Retrieve a Linear template by ID or name: the content it pre-fills, the ids it applies, its sub-issues, and its form fields. Pass the template to save_issue or save_project to apply it. References come back as ids, so read a name with the matching tool when you need one. A form template collects its answers through a form, so applying one here creates an issue with the form unanswered.

get_template

Retrieve who is responsible for a team's triage: the person on triage now, what happens when an issue enters triage, and the upcoming shifts of the team's triage rotation. Pass `user` to get only that person's shifts, for example to find when their next triage duty starts, even when it is weeks away.

get_triage_responsibility

Retrieve one user's profile, email, admin, guest, and active flags, plus team IDs, names, and keys. Use list_users to find matching users.

get_user

Retrieve the connected workspace's ID, name, and URL to confirm which workspace you are using

get_workspace

List Linear Agent skills available to the authenticated user.

list_agent_skills

List comments on a Linear issue, project, initiative, document, project milestone, or project/initiative status update. Provide exactly one of `issueId`, `projectId`, `initiativeId`, `documentId`, `milestoneId`, or `statusUpdateId`. `statusUpdateType` applies only to `statusUpdateId`; omit it for every other parent. For issues, projects, and initiatives this returns both top-level discussion threads and inline description comments. Inline (anchored) comments carry a non-null `quotedText` set to the snippet of description text they reference. Returned comments include `author` and nullable `onBehalfOf`; when set, `onBehalfOf` identifies the user the agent author acted for. Files uploaded in comment bodies are returned in `attachments` with titles and download URLs, not issue attachment IDs. Signed upload URLs expire after five minutes; call list_comments again to refresh them. Download documents using these URLs and process them with your own file tools.

list_comments

Find saved issue, project, and initiative views accessible to the user, including personal, workspace, and team views. Excludes archived views and views scoped to a project or initiative. Returns view metadata, not the records matching its filters.

list_custom_views

List customer needs (customer requests) for an issue, project, or initiative. Provide exactly one of `issue`, `project`, or `initiative`. Project results include requests linked to the project's issues; initiative results include requests on projects in the initiative or any of its sub-initiatives, and on their issues. Returns requests on closed work too; each need includes its issue's workflow state and its project's status so callers can filter. Paginated; pass `cursor` from the previous page to fetch the next.

list_customer_needs

List customers in the user's Linear workspace

list_customers

List a team's cycles with their IDs, numbers, dates, and issue and scope histories

list_cycles

List Linear diff pull requests visible to the authenticated user

list_diffs

List documents in the user's Linear workspace

list_documents

List available initiative labels in the Linear workspace. Pass `includeGroups` to include groups, which return `groupType`; child labels return their `parent` and `parentGroupType`. A retired label carries `retiredAt` and cannot be applied to new initiatives.

list_initiative_labels

List initiatives in the user's Linear workspace

list_initiatives

List available issue labels in a Linear workspace or team. A retired label carries `retiredAt` and cannot be applied to new issues.

list_issue_labels

List available issue statuses in a Linear team

list_issue_statuses

List issues in the user's Linear workspace, including active Triage Intelligence suggestions for issues in triage. For issues assigned to me, use "me" as the assignee. For issues created by me, use "me" as the creator. Use "null" for no assignee.

list_issues

List available project labels in a Linear workspace or team. Returns workspace labels by default; pass `team` to also include that team's labels. Pass `includeGroups` to include groups, which return `groupType`; child labels return their `parent` and `parentGroupType`. A team-scoped label carries a `team` field; different teams can hold same-named labels, so check it before acting on an ID. A retired label carries `retiredAt` and cannot be applied to new projects.

list_project_labels

List all milestones in a Linear project

list_milestones

List projects in the user's Linear workspace

list_projects

List release notes in the workspace, optionally filtered by pipeline or covered release.

list_release_notes