Skip to main content
Glama

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

get_issue

Obtener una incidencia por identificador

list_my_issues

Incidencias asignadas al propietario de la clave de API

search_issues

Búsqueda de texto completo con filtros de equipo/estado/asignado

create_issue

Crear una incidencia en un equipo

update_issue

Actualizar campos de una incidencia existente

get_comments

Comentarios de una incidencia

add_comment

Publicar un comentario

list_teams

Claves y nombres de equipos

list_states

Estados de flujo de trabajo de un equipo

list_labels

Etiquetas de un equipo más etiquetas del espacio de trabajo (equipo opcional)

list_users

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_KEY

Obté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/pytest

Todo 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 issueLabels

  • viewer.assignedIssues(orderBy: updatedAt)

  • todos los campos que envían las tres mutaciones: IssueCreateInput, IssueUpdateInput y CommentCreateInput aceptan teamId, title, description, stateId, assigneeId, priority, labelIds, issueId y body tal como se usan.

Se encontró y corrigió una divergencia:

  • Búsqueda de texto completo. issueSearch rechaza su argumento query como obsoleto. La búsqueda ahora usa searchIssues(term: ...), que devuelve IssueSearchPayload cuyos nodos son IssueSearchResult, no Issue, por lo que no puede expandir el fragmento IssueFields. queries.py declara un segundo fragmento, SearchFields, con la misma selección en ese tipo. La introspección confirmó que IssueSearchResult contiene todos los campos que selecciona IssueFields. Si cambias un fragmento, cambia el otro.

Una cosa sigue sin confirmar:

  • Etiquetas del espacio de trabajo. La conexión raíz issueLabels se 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 prefijo Bearer.

  • Linear informa la mayoría de los fallos como HTTP 200 con una matriz errors de 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 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