Skip to main content
Glama

mcp-linear

Linear 이슈 작업을 노출하는 MCP 서버. 독립형 — 내장된 Claude Linear MCP에 의존하지 않습니다.

이슈는 사람이 읽을 수 있는 식별자(GOV-123)로 주소가 지정됩니다. 상태, 팀, 라벨, 담당자는 이름으로 지정되며, 서버가 이를 Linear UUID로 변환하고 이름이 일치하지 않으면 유효한 옵션을 나열하는 오류를 반환합니다.

도구

도구

설명

get_issue

식별자로 이슈 가져오기

list_my_issues

API 키 소유자에게 할당된 이슈

search_issues

팀/상태/담당자 필터가 있는 전체 텍스트 검색

create_issue

팀에 이슈 생성

update_issue

기존 이슈의 필드 업데이트

get_comments

이슈에 대한 댓글

add_comment

댓글 게시

list_teams

팀 키 및 이름

list_states

팀의 워크플로 상태

list_labels

팀의 라벨 및 워크스페이스 라벨(팀 선택 사항)

list_users

활성 사용자

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_KEY

API 키 받기: 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 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