mcp-linear
mcp-linear
Linear 이슈 작업을 노출하는 MCP 서버. 독립형 — 내장된 Claude Linear MCP에 의존하지 않습니다.
이슈는 사람이 읽을 수 있는 식별자(GOV-123)로 주소가 지정됩니다. 상태, 팀, 라벨, 담당자는 이름으로 지정되며, 서버가 이를 Linear UUID로 변환하고 이름이 일치하지 않으면 유효한 옵션을 나열하는 오류를 반환합니다.
도구
도구 | 설명 |
| 식별자로 이슈 가져오기 |
| API 키 소유자에게 할당된 이슈 |
| 팀/상태/담당자 필터가 있는 전체 텍스트 검색 |
| 팀에 이슈 생성 |
| 기존 이슈의 필드 업데이트 |
| 이슈에 대한 댓글 |
| 댓글 게시 |
| 팀 키 및 이름 |
| 팀의 워크플로 상태 |
| 팀의 라벨 및 워크스페이스 라벨(팀 선택 사항) |
| 활성 사용자 |
Related MCP server: Linear MCP Server
설정
python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"
cp .env.example .env
# Edit .env — set LINEAR_API_KEYAPI 키 받기: Linear → 설정 → 보안 및 액세스 → 개인 API 키. 쓰기 작업에는 쓰기 액세스 권한이 있는 키가 필요합니다.
Claude Code에 추가
{
"mcpServers": {
"linear": {
"command": "/Users/piuschungath/Workspace/mcp-linear/.venv/bin/mcp-linear",
"env": { "LINEAR_API_KEY": "lin_api_..." }
}
}
}테스트
.venv/bin/pytest모든 HTTP는 respx로 모킹됩니다. API 키나 네트워크 액세스가 필요 없습니다.
mcp-pr-assistant와 함께 사용
두 서버는 서로를 임포트하지 않고도 구성됩니다: get_issue로 티켓을 가져오고, 해당 필드를 create_pr_from_ticket에 전달한 다음, add_comment로 PR URL을 다시 게시합니다.
스키마 검증
src/mcp_linear/queries.py의 GraphQL 필드 이름은 2026-08-21에 실제 Linear API에 대해 검증되었으며, 도구의 실제 쿼리 문자열(복사본이 아닌)을 실제 워크스페이스에 대해 실행하여 확인했습니다.
검증 완료:
Float!이슈 번호 비교자team { labels }를 통한 팀 범위 라벨루트
issueLabels연결viewer.assignedIssues(orderBy: updatedAt)세 가지 변형이 전송하는 모든 필드 —
IssueCreateInput,IssueUpdateInput및CommentCreateInput모두 사용된 대로teamId,title,description,stateId,assigneeId,priority,labelIds,issueId및body를 수용합니다.
하나의 차이가 발견되어 수정되었습니다:
전체 텍스트 검색.
issueSearch는query인수를 더 이상 사용되지 않는 것으로 거부합니다. 검색은 이제searchIssues(term: ...)를 사용하며, 이는 노드가IssueSearchResult인IssueSearchPayload를 반환합니다 —Issue가 아닙니다 — 따라서IssueFields프래그먼트를 확산할 수 없습니다.queries.py는 해당 유형에 대해 동일한 선택을 가진 두 번째 프래그먼트SearchFields를 선언합니다. 인트로스펙션은IssueSearchResult가IssueFields가 선택하는 모든 필드를 보유함을 확인했습니다. 한 프래그먼트를 변경하면 다른 프래그먼트도 변경하세요.
한 가지는 아직 확인되지 않았습니다:
워크스페이스 라벨. 루트
issueLabels연결은 해석되지만, 워크스페이스 전체 라벨만 반환하는지 — 아니면 다른 팀에 속한 팀 범위 라벨도 반환하는지 — 는 확인되지 않았습니다. 라벨 해석은 팀 자체 라벨을 먼저 참조하므로 팀 라벨이 항상 같은 이름의 워크스페이스 라벨보다 우선합니다.
Linear 스키마 변경 후 재검증하려면:
LINEAR_API_KEY=lin_api_... .venv/bin/python scripts/probe_schema.py <team-key> <issue-number> <issue-uuid>팀 키, 해당 팀의 기존 이슈 번호, 해당 이슈의 UUID가 필요합니다(첫 번째 프로브에서 출력된 팀 UUID에 대해 한 번 대화형으로 프롬프트). 프로브는 읽기 전용입니다: 변형은 입력 유형을 인트로스펙션하여 확인되며, 트래커에 쓰지 않습니다.
참고 사항
Linear 개인 API 키는
Bearer접두사 없이Authorization: <key>로 전송됩니다.Linear는 대부분의 실패를 최상위
errors배열이 있는 HTTP 200으로 보고하므로, 클라이언트는 상태 코드가 아닌 응답 본문을 확인합니다.팀, 상태, 라벨 및 사용자 메타데이터는 서버 프로세스 수명 동안 캐시됩니다. 팀의 워크플로 상태나 라벨을 변경한 후에는 서버를 다시 시작하세요.
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-