mcp-linear
mcp-linear
Servidor MCP que expone operaciones de incidencias de Linear. Independiente: sin dependencia del MCP de Linear integrado en Claude.
Las incidencias se identifican por su identificador humano (GOV-123). Los estados, equipos, etiquetas y asignados se indican por nombre; el servidor los resuelve a UUID de Linear y devuelve un error con las opciones válidas cuando un nombre no coincide.
Herramientas
Herramienta | Descripción |
| Obtener una incidencia por identificador |
| Incidencias asignadas al propietario de la clave de API |
| Búsqueda de texto completo con filtros de equipo/estado/asignado |
| Crear una incidencia en un equipo |
| Actualizar campos de una incidencia existente |
| Comentarios de una incidencia |
| Publicar un comentario |
| Claves y nombres de equipos |
| Estados de flujo de trabajo de un equipo |
| Etiquetas de un equipo más etiquetas del espacio de trabajo (equipo opcional) |
| Usuarios activos |
Related MCP server: Linear MCP Server
Configuración
python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"
cp .env.example .env
# Edit .env — set LINEAR_API_KEYObtén una clave de API: Linear → Configuración → Seguridad y acceso → Claves de API personales. Las operaciones de escritura necesitan una clave con acceso de escritura.
Añadir a Claude Code
{
"mcpServers": {
"linear": {
"command": "/Users/piuschungath/Workspace/mcp-linear/.venv/bin/mcp-linear",
"env": { "LINEAR_API_KEY": "lin_api_..." }
}
}
}Pruebas
.venv/bin/pytestTodo el HTTP se simula con respx. No se necesita clave de API ni acceso a la red.
Con mcp-pr-assistant
Los dos servidores se combinan sin importarse entre sí: obtén un ticket con get_issue, pasa sus campos a create_pr_from_ticket y luego publica la URL del PR de vuelta con add_comment.
Verificación del esquema
Los nombres de campos GraphQL en src/mcp_linear/queries.py se verificaron contra la API de Linear en vivo el 2026-08-21, ejecutando las cadenas de consulta reales de las herramientas (no copias) contra un espacio de trabajo real.
Verificado correcto:
el comparador de número de incidencia
Float!etiquetas de ámbito de equipo mediante
team { labels }la conexión raíz
issueLabelsviewer.assignedIssues(orderBy: updatedAt)todos los campos que envían las tres mutaciones:
IssueCreateInput,IssueUpdateInputyCommentCreateInputaceptanteamId,title,description,stateId,assigneeId,priority,labelIds,issueIdybodytal como se usan.
Se encontró y corrigió una divergencia:
Búsqueda de texto completo.
issueSearchrechaza su argumentoquerycomo obsoleto. La búsqueda ahora usasearchIssues(term: ...), que devuelveIssueSearchPayloadcuyos nodos sonIssueSearchResult, noIssue, por lo que no puede expandir el fragmentoIssueFields.queries.pydeclara un segundo fragmento,SearchFields, con la misma selección en ese tipo. La introspección confirmó queIssueSearchResultcontiene todos los campos que seleccionaIssueFields. Si cambias un fragmento, cambia el otro.
Una cosa sigue sin confirmar:
Etiquetas del espacio de trabajo. La conexión raíz
issueLabelsse resuelve, pero no se estableció si devuelve solo etiquetas de todo el espacio de trabajo o también etiquetas de ámbito de equipo que pertenecen a otros equipos. La resolución de etiquetas consulta primero las etiquetas propias del equipo, por lo que una etiqueta de equipo siempre gana sobre una del espacio de trabajo con el mismo nombre.
Para volver a verificar después de un cambio de esquema de Linear:
LINEAR_API_KEY=lin_api_... .venv/bin/python scripts/probe_schema.py <team-key> <issue-number> <issue-uuid>Toma una clave de equipo, un número de incidencia existente en ese equipo y el UUID de esa incidencia (y solicita una vez, de forma interactiva, un UUID de equipo impreso por su primera sonda). La sonda es de solo lectura: las mutaciones se verifican inspeccionando sus tipos de entrada, nunca escribiendo en tu rastreador.
Notas
Las claves de API personales de Linear se envían como
Authorization: <key>sin prefijoBearer.Linear informa la mayoría de los fallos como HTTP 200 con una matriz
errorsde nivel superior, por lo que el cliente verifica el cuerpo de la respuesta en lugar del código de estado.Los metadatos de equipos, estados, etiquetas y usuarios se almacenan en caché durante la vida del proceso del servidor. Reinicia el servidor después de cambiar los estados de flujo de trabajo o las etiquetas de un equipo.
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-