mcp-linear
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 |
| Ein Issue anhand der Kennung abrufen |
| Issues, die dem Inhaber des API-Schlüssels zugewiesen sind |
| Volltextsuche mit Team-/Status-/Bearbeiter-Filtern |
| Ein Issue in einem Team erstellen |
| Felder eines bestehenden Issues aktualisieren |
| Kommentare zu einem Issue |
| Einen Kommentar posten |
| Team-Schlüssel und -Namen |
| Workflow-Status für ein Team |
| Labels eines Teams plus Workspace-Labels (Team optional) |
| 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_KEYAPI-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/pytestDer 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-Nummernteambezogene Labels über
team { labels }die Root-Verbindung
issueLabelsviewer.assignedIssues(orderBy: updatedAt)jedes Feld, das die drei Mutationen senden —
IssueCreateInput,IssueUpdateInputundCommentCreateInputakzeptieren alleteamId,title,description,stateId,assigneeId,priority,labelIds,issueIdundbodywie verwendet
Eine Abweichung wurde gefunden und behoben:
Volltextsuche.
issueSearchlehnt seinquery-Argument als veraltet ab. Die Suche verwendet nunsearchIssues(term: ...), dasIssueSearchPayloadzurückgibt, dessen KnotenIssueSearchResultsind, nichtIssue— daher kann es dasIssueFields-Fragment nicht einbetten.queries.pydeklariert ein zweites Fragment,SearchFields, mit derselben Auswahl auf diesem Typ. Die Introspection bestätigte, dassIssueSearchResultjedes Feld enthält, dasIssueFieldsauswählt. Wenn Sie ein Fragment ändern, ändern Sie auch das andere.
Eine Sache bleibt unbestätigt:
Workspace-Labels. Die Root-Verbindung
issueLabelswird 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>ohneBearer-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 toolsadd_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
Scored across 11 tools
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.
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.
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.
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
Related MCP Connectors
Search, read and create Linear issues, projects, teams and cycles.
Issues, projects, cycles, and roadmaps via the official Linear hosted MCP server.
Find and manage issues, projects, and documents in your Linear workspace.
Unofficial Linear MCP — wraps the Linear GraphQL API (OAuth)
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAllows LLMs to integrate with Linear's issue tracking system, enabling them to create, update, search, and comment on issues through the Linear API.-
- AlicenseBqualityDmaintenanceEnables interaction with Linear's API to manage issues, projects, and teams. Supports creating, updating, searching, and deleting issues, along with project management and team operations through API key authentication.13ISC
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to interact with Linear's issue tracking system, including creating, updating, searching issues, adding comments, and accessing resources via the Linear API.MIT
- FlicenseAqualityDmaintenanceEnables AI agents to search, create, update, and manage Linear issues through natural language, with support for teams, workflows, and comments.91-