Skip to main content
Glama

mcp-linear

MCP-Server, der Linear-Issue-Operationen bereitstellt. Eigenständig — keine Abhängigkeit vom integrierten Claude-Linear-MCP.

Issues werden über ihre menschenlesbare Kennung (GOV-123) angesprochen. Status, Teams, Labels und Bearbeiter werden namentlich angegeben; der Server löst sie in Linear-UUIDs auf und gibt bei fehlender Übereinstimmung einen Fehler mit den gültigen Optionen zurück.

Tools

Tool

Beschreibung

get_issue

Ein Issue anhand der Kennung abrufen

list_my_issues

Issues, die dem Inhaber des API-Schlüssels zugewiesen sind

search_issues

Volltextsuche mit Team-/Status-/Bearbeiter-Filtern

create_issue

Ein Issue in einem Team erstellen

update_issue

Felder eines bestehenden Issues aktualisieren

get_comments

Kommentare zu einem Issue

add_comment

Einen Kommentar posten

list_teams

Team-Schlüssel und -Namen

list_states

Workflow-Status für ein Team

list_labels

Labels eines Teams plus Workspace-Labels (Team optional)

list_users

Aktive Benutzer

Related MCP server: Linear MCP Server

Setup

python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"
cp .env.example .env
# Edit .env — set LINEAR_API_KEY

API-Schlüssel erhalten: Linear → Settings → Security & access → Personal API keys. Für Schreiboperationen wird ein Schlüssel mit Schreibzugriff benötigt.

Zu Claude Code hinzufügen

{
  "mcpServers": {
    "linear": {
      "command": "/Users/piuschungath/Workspace/mcp-linear/.venv/bin/mcp-linear",
      "env": { "LINEAR_API_KEY": "lin_api_..." }
    }
  }
}

Tests

.venv/bin/pytest

Der gesamte HTTP-Verkehr wird mit respx gemockt. Es werden weder ein API-Schlüssel noch Netzwerkzugriff benötigt.

Mit mcp-pr-assistant

Die beiden Server lassen sich kombinieren, ohne sich gegenseitig zu importieren: Ein Ticket mit get_issue abrufen, seine Felder an create_pr_from_ticket übergeben und anschließend die PR-URL mit add_comment zurückposten.

Schema-Verifizierung

Die GraphQL-Feldnamen in src/mcp_linear/queries.py wurden am 2026-08-21 gegen die Live-Linear-API verifiziert, indem die tatsächlichen Query-Strings der Tools (nicht Kopien davon) gegen einen echten Workspace ausgeführt wurden.

Als korrekt verifiziert:

  • der Float!-Vergleichsoperator für Issue-Nummern

  • teambezogene Labels über team { labels }

  • die Root-Verbindung issueLabels

  • viewer.assignedIssues(orderBy: updatedAt)

  • jedes Feld, das die drei Mutationen senden — IssueCreateInput, IssueUpdateInput und CommentCreateInput akzeptieren alle teamId, title, description, stateId, assigneeId, priority, labelIds, issueId und body wie verwendet

Eine Abweichung wurde gefunden und behoben:

  • Volltextsuche. issueSearch lehnt sein query-Argument als veraltet ab. Die Suche verwendet nun searchIssues(term: ...), das IssueSearchPayload zurückgibt, dessen Knoten IssueSearchResult sind, nicht Issue — daher kann es das IssueFields-Fragment nicht einbetten. queries.py deklariert ein zweites Fragment, SearchFields, mit derselben Auswahl auf diesem Typ. Die Introspection bestätigte, dass IssueSearchResult jedes Feld enthält, das IssueFields auswählt. Wenn Sie ein Fragment ändern, ändern Sie auch das andere.

Eine Sache bleibt unbestätigt:

  • Workspace-Labels. Die Root-Verbindung issueLabels wird aufgelöst, aber ob sie nur workspaceweite Labels zurückgibt — oder auch teambezogene Labels anderer Teams — wurde nicht festgestellt. Bei der Label-Auflösung werden zuerst die eigenen Labels eines Teams berücksichtigt, sodass ein Team-Label immer über einem gleichnamigen Workspace-Label gewinnt.

Zur erneuten Verifizierung nach einer Linear-Schemaänderung:

LINEAR_API_KEY=lin_api_... .venv/bin/python scripts/probe_schema.py <team-key> <issue-number> <issue-uuid>

Er benötigt einen Team-Schlüssel, eine bestehende Issue-Nummer in diesem Team und die UUID dieses Issues (und fragt einmalig interaktiv nach einer Team-UUID, die sein erster Testlauf ausgibt). Der Testlauf ist schreibgeschützt: Die Mutationen werden durch Introspection ihrer Eingabetypen geprüft, niemals durch Schreiben in Ihren Tracker.

Hinweise

  • Persönliche Linear-API-Schlüssel werden als Authorization: <key> ohne Bearer-Präfix gesendet.

  • Linear meldet die meisten Fehler als HTTP 200 mit einem errors-Array auf oberster Ebene, daher prüft der Client den Antworttext statt des Statuscodes.

  • Team-, Status-, Label- und Benutzermetadaten werden für die Lebensdauer des Serverprozesses zwischengespeichert. Starten Sie den Server neu, nachdem Sie die Workflow-Status oder Labels eines Teams geändert haben.

Available Tools

11 tools
add_commentA

Post a comment on a Linear issue. Markdown is supported. identifier: human issue identifier, e.g. "GOV-123".

Inputs: body (required), identifier (required).

create_issueA

Create a Linear issue. Returns the created issue including its new identifier. team: team key or name, e.g. "GOV". assignee: user display name or email. See list_users. state: workflow state name, e.g. "Backlog". See list_states. priority: 0 none, 1 urgent, 2 high, 3 medium, 4 low. labels: label names on that team. See list_labels.

Inputs: team (required), title (required), state, labels, +3 more.

get_commentsA

Fetch the comments on a Linear issue, oldest first. identifier: human issue identifier, e.g. "GOV-123".

Inputs: identifier (required). Returns: result

get_issueA

Fetch a Linear issue by its human identifier, e.g. "GOV-123". Returns title, description, state, assignee, team, priority, labels, URL, and the git branch name Linear suggests for the issue.

Inputs: identifier (required).

list_labelsA

List the issue labels that can be applied to an issue, as {name}. team: optional team key or full team name. With a team, returns that team's own labels followed by the workspace-wide labels; without one, the workspace-wide labels only. Names are what create_issue and update_issue accept for labels.

Inputs: team. Returns: result

list_my_issuesA

List issues assigned to the owner of the configured API key, most recently updated first. state: optional state-name filter, e.g. "In Progress". Case-insensitive. The filter is applied after the fetch, so passing one makes the server over-fetch (four times limit, at least 50 issues) and then cut the result back to limit. It is therefore best-effort within that window: a matching issue further down the list than the window reaches is not returned. Raise limit if you suspect one is missing. limit: maximum number of issues returned.

Inputs: limit, state. Returns: result

list_statesA

List the workflow states for a team, in workflow order, as {name, type}. These names are what create_issue and update_issue accept for state. team: team key or full team name.

Inputs: team (required). Returns: result

list_teamsA

List Linear teams as {key, name}. Team keys are the prefix of issue identifiers, e.g. the GOV in GOV-123.

Inputs: no named parameters. Returns: result

list_usersA

List active Linear users as {name, email}. name is the display name that create_issue and update_issue accept for assignee. query: optional case-insensitive substring filter over name and email.

Inputs: query. Returns: result

search_issuesA

Full-text search over Linear issues, with optional filters. team: team key or full team name, e.g. "GOV" or "Governance". state: workflow state name, e.g. "In Progress". Resolved against the team's workflow when team is given; without a team there is no workflow to resolve against, so the value is sent as written and must match the state name Linear stores. assignee: user display name, full name, or email. See list_users. Names are resolved the same way create_issue resolves them: a name that does not match returns an error listing the valid options, not an empty result.

Inputs: query (required), team, limit, state, +1 more. Returns: result

update_issueA

Update fields on an existing Linear issue. Only the fields you pass are changed. identifier: human issue identifier, e.g. "GOV-123". state, assignee, labels: names, resolved against the issue's own team. priority: 0 none, 1 urgent, 2 high, 3 medium, 4 low. Passing labels replaces the issue's labels entirely.

Inputs: identifier (required), state, title, labels, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action: list_* clearly separates teams, states, labels, users, and my issues, while get_issue, search_issues, and list_my_issues offer different retrieval modes. Comments, creation, and updates are also cleanly separated with no overlapping responsibilities.

    Naming Consistency5/5

    The tools consistently follow a verb_noun snake_case pattern: list_teams, list_states, get_issue, create_issue, update_issue, add_comment, and so on. list_my_issues is a minor variation but still predictable and fits the overall naming logic.

    Tool Count5/5

    With 11 tools, the server is well-scoped for a Linear issue-management integration. It provides reference lookups, issue operations, and comments without redundant or unnecessary tools.

    Completeness4/5

    The core issue lifecycle is covered: create, get, update, search, list-my-issues, and comments, plus supporting lookups for teams, states, labels, and users. Obvious gaps like deleting/archiving issues or listing all issues in a team are minor and can often be worked around with search_issues.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers