Skip to main content
Glama

mcp-linear

MCP-сервер, предоставляющий операции с задачами Linear. Автономный — не зависит от встроенного Claude Linear MCP.

Задачи адресуются по человекочитаемому идентификатору (GOV-123). Статусы, команды, метки и исполнители задаются по имени; сервер преобразует их в UUID Linear и возвращает ошибку со списком допустимых вариантов, если имя не совпало.

Инструменты

Инструмент

Описание

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 → Settings → Security & access → Personal API keys. Для операций записи нужен ключ с правом записи.

Добавление в 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, затем отправьте URL PR обратно через add_comment.

Проверка схемы

Имена полей GraphQL в src/mcp_linear/queries.py были проверены против живого API Linear 2026-08-21 путём выполнения фактических строк запросов инструментов (не их копий) в реальном рабочем пространстве.

Проверено корректно:

  • компаратор номера задачи Float!

  • метки в рамках команды через team { labels }

  • корневое соединение issueLabels

  • viewer.assignedIssues(orderBy: updatedAt)

  • каждое поле, которое отправляют три мутации — IssueCreateInput, IssueUpdateInput и CommentCreateInput — все принимают teamId, title, description, stateId, assigneeId, priority, labelIds, issueId и body в том виде, как они используются

Было обнаружено и исправлено одно расхождение:

  • Полнотекстовый поиск. issueSearch отклоняет свой аргумент query как устаревший. Поиск теперь использует searchIssues(term: ...), который возвращает IssueSearchPayload, чьи узлы — IssueSearchResult, а не 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 команды, выведенный первым пробным запросом). Пробный запрос доступен только для чтения: мутации проверяются путём интроспекции их типов ввода, а не записью в ваш трекер.

Примечания

  • Личные API-ключи Linear отправляются как Authorization: <key> без префикса Bearer.

  • Linear сообщает о большинстве сбоев как HTTP 200 с массивом errors на верхнем уровне, поэтому клиент проверяет тело ответа, а не код состояния.

  • Метаданные команд, статусов, меток и пользователей кэшируются на время жизни процесса сервера. Перезапустите сервер после изменения статусов рабочего процесса или меток команды.

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