Skip to content

Linear

Linear is the issue tracker for modern product and engineering teams. AllMCP provides 100 tools across 23 categories — issues, projects, cycles, initiatives, teams, users, labels, comments, documents, customers and more — behind a single endpoint.

All providers How connecting works

Linear connects with a personal API key that you create inside your own Linear workspace. There is no OAuth screen and nothing to re-authorize on a schedule — the key does not expire until you revoke it.

  1. Create a personal API key

    In Linear, go to Settings → Security & access → Personal API keys (or open linear.app/settings/account/security, which redirects to your own workspace), click New key, name it something like “AllMCP”, and copy the value. Linear shows the key once.

  2. Open the secure key-entry page

    Ask your agent to connect Linear. It replies with a browser link to the AllMCP key-entry page — the agent never sees or handles the key itself. Paste the key there. One field is required:

    • API key — the value you copied above.
  3. Start asking for work

    Once the key is saved, the Linear tools are live on your existing AllMCP endpoint. Nothing else to install.


Once Linear is connected, your agent can use the tools below. You never call them by name — describe the outcome you want in plain language and the agent picks the tools and resolves the IDs.

Seven categories are available the moment you connect — issues, users, teams, projects, comments, search and labels — which is where the large majority of day-to-day work happens. The remaining sixteen become available as soon as a request needs them.

ToolWhat it does
linear_list_issuesLists issues, filtered by team, assignee, workflow state, project, cycle, label, priority or a title substring, sorted by last update or creation date.
linear_get_issueRetrieves one issue in full — by its ID or its human identifier such as ENG-123 — including description, creator, subscribers and sub-issues.
linear_create_issueCreates an issue in a team, optionally with a Markdown description, assignee, starting status, priority, estimate, project, cycle, labels, parent issue and due date.
linear_update_issueChanges an issue’s title, description, assignee, status, priority, estimate, project, cycle, labels, parent or due date.
linear_archive_issueArchives an issue. Reversible — Linear keeps archived issues.
linear_delete_issuePermanently deletes an issue. Requires an explicit confirmation, and archiving is offered first.
ToolWhat it does
linear_get_viewerIdentifies the member behind the connection, so “assign this to me” resolves to the right person and their teams.
linear_list_usersLists workspace members, optionally matching a display name, and can include or exclude deactivated and archived accounts.
linear_get_userRetrieves one member’s profile along with their team memberships.
ToolWhat it does
linear_list_teamsLists teams, optionally matching a name, so the agent can place an issue in the right one.
linear_get_teamRetrieves one team by ID or key — for example ENG — including its workflow states.
linear_list_workflow_statesLists the workflow states (issue statuses) available, scoped to a team, with the lifecycle type behind each display name.
ToolWhat it does
linear_list_projectsLists projects, filtered by a name substring or lifecycle state, with archived projects optional.
linear_list_project_statusesLists the workspace’s project statuses, so a project can be created in or moved to the right one.
linear_get_projectRetrieves one project in full, including its milestones.
linear_create_projectCreates a project spanning one or more teams, with a description, lead, status and start and target dates.
linear_update_projectChanges a project’s name, description, lead, status or dates.
linear_archive_projectArchives a project. Reversible.
ToolWhat it does
linear_list_labelsLists issue labels, optionally scoped to a team or matched by name — the agent checks here before creating a near-duplicate.
linear_create_labelCreates a label, either team-scoped or workspace-wide, with an optional color, description and parent label group.
linear_update_labelChanges a label’s name, color or description.
linear_delete_labelDeletes a label. Requires confirmation, because deleting removes it from every issue that carries it.
ToolWhat it does
linear_list_commentsLists the comments on an issue, oldest first.
linear_create_commentPosts a Markdown comment on an issue, optionally as a threaded reply to an existing comment.
linear_update_commentRewrites a comment’s body.
linear_delete_commentDeletes a comment. Requires confirmation.
ToolWhat it does
linear_searchFuzzy, ranked search across issues, projects or documents by name or phrase — how the agent finds the thing you described when you did not give it an ID.
ToolWhat it does
linear_list_cyclesLists cycles — a team’s time-boxed sprints — with their dates and completion progress.
linear_get_cycleRetrieves one cycle in full.
linear_create_cycleCreates a cycle for a team with start and end datetimes, plus an optional name and description.
linear_update_cycleChanges a cycle’s name, dates or description.
linear_archive_cycleArchives a cycle. Reversible.
ToolWhat it does
linear_list_initiativesLists the workspace’s initiatives — the high-level goals that group projects — with archived ones optional.
linear_get_initiativeRetrieves one initiative, including the projects rolling up to it.
linear_create_initiativeCreates an initiative with a Markdown description, target date and owner.
linear_update_initiativeChanges an initiative’s name, description, target date, owner or lifecycle status — Proposed, Planned, Active, Completed or Canceled.
linear_archive_initiativeArchives an initiative. Un-archiving is done in the Linear app.
ToolWhat it does
linear_list_issue_relationsLists the links an issue points outward at — what it blocks, what it relates to, what it duplicates.
linear_create_issue_relationLinks two issues as blocks, related or duplicate.
linear_delete_issue_relationRemoves a link between two issues. Requires confirmation.
ToolWhat it does
linear_list_milestonesLists a project’s milestones.
linear_get_milestoneRetrieves one project milestone.
linear_create_milestoneAdds a dated checkpoint to a project, with an optional target date and description.
linear_update_milestoneChanges a milestone’s name, target date or description.
linear_delete_milestoneDeletes a project milestone. Requires confirmation.
ToolWhat it does
linear_list_project_updatesLists a project’s status updates, newest first.
linear_create_project_updatePosts a status update on a project — a Markdown body plus an optional health signal of on track, at risk or off track.
linear_edit_project_updateEdits an existing status update’s body or health signal.
linear_delete_project_updateDeletes a project status update. Requires confirmation.
ToolWhat it does
linear_list_documentsLists the workspace’s documents by title, newest first.
linear_get_documentRetrieves one document including its full Markdown content.
linear_create_documentCreates a document with Markdown content and an optional icon, either standalone or attached to a project.
linear_update_documentChanges a document’s title or replaces its content.
linear_delete_documentDeletes a document. Requires confirmation.
ToolWhat it does
linear_list_attachmentsLists the external links surfaced on an issue.
linear_link_urlAttaches an external URL — a pull request, a Figma file, a monitoring alert — to an issue, with an optional display title. Linking the same URL twice updates the existing link instead of duplicating it.
linear_update_attachmentChanges an attachment’s title or subtitle.
linear_delete_attachmentRemoves an attachment from an issue. Requires confirmation.
ToolWhat it does
linear_list_customersLists the companies recorded as customers in your workspace.
linear_get_customerRetrieves one customer by ID or slug.
linear_list_customer_statusesLists your workspace’s customer statuses, such as Prospect, Active or Churned.
linear_list_customer_tiersLists your workspace’s customer tiers, such as Enterprise, Pro or Free.
linear_create_customerCreates a customer company with domains, owner, annual revenue, headcount, status and tier.
linear_update_customerChanges a customer’s name, domains, owner, revenue, size, status or tier.
linear_delete_customerDeletes a customer. Requires confirmation — customers have no archive.
linear_list_customer_needsLists the requests logged against customers, across all of them.
linear_create_customer_needLogs a customer request and ties it to the issue or project that tracks it, with an importance flag.
linear_delete_customer_needDeletes a customer request. Requires confirmation.
ToolWhat it does
linear_list_releasesLists the workspace’s releases.
linear_get_releaseRetrieves one release in full.
linear_create_releaseCreates a release inside a pipeline, with a version string, description and start and target dates.
linear_update_releaseChanges a release’s name, version, description or target date.
linear_delete_releaseDeletes a release. Requires confirmation.
linear_list_release_notesLists release notes.
linear_get_release_noteRetrieves one release note’s details.
linear_list_release_pipelinesLists release pipelines, so a new release is filed under the right one.
linear_get_release_pipelineRetrieves one release pipeline.
ToolWhat it does
linear_list_custom_viewsLists saved custom views — both your personal ones and those shared with the workspace.
linear_get_custom_viewRetrieves one custom view by ID or slug, including the filter behind it.
linear_create_custom_viewSaves a new custom view, optionally scoped to a team, shared with the workspace, and backed by an issue filter.
linear_update_custom_viewChanges a custom view’s name, description, sharing or filter.
linear_delete_custom_viewDeletes a custom view. Requires confirmation.
linear_list_favoritesLists the current user’s pinned favorites.
linear_create_favoritePins an issue, project, document, custom view or cycle to favorites.
linear_delete_favoriteUnpins a favorite.
ToolWhat it does
linear_list_templatesLists the issue and project templates defined in your workspace.
linear_get_templateRetrieves one template, including the pre-filled scaffold it applies.
ToolWhat it does
linear_list_notificationsLists the connected member’s notification inbox, newest first.
linear_get_notificationRetrieves one notification.
linear_archive_notificationDismisses a notification by archiving it. One-way, and separate from marking it read.
ToolWhat it does
linear_get_organizationRetrieves the workspace behind the connection, including which optional features — releases, customers, roadmaps — are switched on.
linear_list_integrationsLists the third-party apps connected to the workspace. Read-only.
ToolWhat it does
linear_add_reactionAdds an emoji reaction to an issue or a comment.
linear_remove_reactionRemoves a reaction.
ToolWhat it does
linear_list_roadmapsLists roadmaps. Linear has superseded roadmaps with initiatives — these tools are here for workspaces still using them.
linear_get_roadmapRetrieves one roadmap by ID or slug.
linear_create_roadmapCreates a roadmap with a description, owner and color.
linear_update_roadmapChanges a roadmap’s name, description or color.
linear_archive_roadmapArchives a roadmap. Reversible.
ToolWhat it does
linear_get_issue_historyReads an issue’s change log — who moved it between states, reassigned it, or changed its priority or labels, and when.

Describe the outcome in plain language. The agent resolves the team, the person and the status behind the scenes.

File a bug in the Mobile team: "Login screen crashes on iOS 17", mark it urgent and assign it to Marina

  • You speak in names, the agent works in IDs. Linear identifies teams, people, statuses and labels by internal ID, so the agent looks each one up before it writes. That means “assign it to Marina” works — but a name that matches several members will make the agent ask which one you meant rather than guess.
  • Statuses belong to teams. Each team names its own workflow states, so “Done” in one team is a different status from “Done” in another. Ask about a status in the context of its team.
  • Priority is a fixed five-step scale — no priority, urgent, high, medium, low — the same one you see in the Linear app.
  • Archiving is the safe default; deleting is not. Issues, projects, cycles, initiatives and roadmaps can be archived and brought back. Permanent deletes — of issues, comments, labels, documents, milestones, views, customers and releases — always require an explicit confirmation first.
  • Customers and Releases need to be enabled for your workspace. If those features are off, those tools report a permission error rather than returning empty results. Roadmaps are Linear’s legacy feature — prefer initiatives for new work.
  • Search covers titles and descriptions, not comment threads. If something was only ever said in a comment, ask the agent to open the issue and read its comments.
  • Descriptions, comments, documents and status updates are Markdown, and an update replaces the existing body rather than appending to it. Ask the agent to read the current text back before it rewrites anything long.
  • Linear rate-limits personal API keys to roughly 1,500 requests per hour, so very large sweeps are paged through steadily. If you hit the ceiling, the agent tells you and backs off rather than hammering the API.
  • Webhooks and account-security operations are deliberately not included. AllMCP will not create or revoke Linear API keys, OAuth apps or sessions on your behalf, and it does not subscribe to Linear events — set those up directly in Linear if you need them.