mcp-linear
mcp-linear
MCP-сервер, предоставляющий операции с задачами Linear. Автономный — не зависит от встроенного Claude Linear MCP.
Задачи адресуются по человекочитаемому идентификатору (GOV-123). Статусы, команды, метки и исполнители задаются по имени; сервер преобразует их в UUID Linear и возвращает ошибку со списком допустимых вариантов, если имя не совпало.
Инструменты
Инструмент | Описание |
| Получить задачу по идентификатору |
| Задачи, назначенные на владельца 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_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 }корневое соединение
issueLabelsviewer.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 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-