Linear MCP Server

MIT License
  • Apple

Integrations

  • Interfaces with Linear's GraphQL API, enabling structured queries and mutations for accessing and manipulating data in the Linear platform.

  • Provides integration with Linear's issue tracking system, allowing management of issues, teams, projects, labels, milestones, and attachments. Supports creating and updating issues, adding comments, searching and filtering issues, managing relationships between issues, and accessing detailed information about teams, projects, and users.

Servidor MCP lineal

Un servidor de protocolo de contexto de modelo para la API lineal .

Este servidor proporciona integración con el sistema de seguimiento de problemas de Linear a través de MCP, lo que permite a los LLM interactuar con los problemas de Linear.

Instalación

Instalación automática

Para instalar automáticamente el servidor Linear MCP para Claude Desktop a través de Smithery :

npx @smithery/cli install mcp-server-linearapp --client claude

Instalación manual

  1. Cree u obtenga una clave API personal de Linear: https://linear.app/settings/account/security
  2. Agregar configuración de servidor a Claude Desktop:
    • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{ "mcpServers": { "linear": { "command": "npx", "args": ["-y", "mcp-server-linearapp"], "env": { "LINEAR_API_KEY": "your_linear_api_key_here" } } } }

Componentes

Herramientas

Herramientas relacionadas con el usuario
  1. linear_get_viewer : Obtener información sobre el usuario autenticado
    • No se requieren entradas
    • Devuelve información del perfil del usuario, incluido ID, nombre, correo electrónico y estado activo.
  2. linear_get_user_issues : Obtener los problemas asignados a un usuario
    • Entradas opcionales:
      • userId (cadena): ID de usuario (omitir para usuario autenticado)
      • includeArchived (booleano): incluye problemas archivados
      • limit (número, predeterminado: 50): Máximo de resultados
  3. linear_get_user_teams : Obtener los equipos asociados con un usuario
    • Entradas opcionales:
      • userId (cadena): ID de usuario para el que se obtendrán los equipos (omitir para usuarios autenticados)
      • includeArchived (booleano): incluye equipos archivados
      • limit (número, predeterminado: 50): Número máximo de equipos a devolver
    • Devuelve la lista de equipos de los que el usuario es miembro
  4. linear_get_user_projects : Obtener proyectos asociados con un usuario
    • Entradas opcionales:
      • userId (cadena): ID de usuario para el que se obtendrán proyectos (omitir para usuarios autenticados)
      • includeArchived (booleano): incluye proyectos archivados
      • limit (número, predeterminado: 50): número máximo de proyectos a devolver
      • status (cadena): filtrar por estado del proyecto (por ejemplo, 'completado', 'en progreso')
    • Devuelve una lista de proyectos en los que el usuario es líder o miembro.
Herramientas relacionadas con el equipo
  1. linear_get_teams : Obtener equipos en la organización
    • Entradas opcionales:
      • includeArchived (booleano): incluye equipos archivados
      • limit (número, predeterminado: 50): Número máximo de equipos a devolver
  2. linear_get_team : Obtener detalles sobre un equipo específico
    • Entradas requeridas:
      • teamId (cadena): ID del equipo para obtener detalles
    • Devuelve información del equipo, incluido nombre, clave, miembros y configuraciones.
  3. linear_get_team_issues : Obtener problemas para un equipo específico
    • Entradas requeridas:
      • teamId (cadena): ID del equipo para el que se obtendrán los problemas
    • Entradas opcionales:
      • includeArchived (booleano): incluye problemas archivados
      • limit (número, predeterminado: 50): número máximo de problemas a devolver
      • status (cadena): Filtrar por estado del problema
      • priority (número): Filtrar por nivel de prioridad
      • assigneeId (cadena): Filtrar por cesionario
Herramientas relacionadas con el proyecto
  1. linear_get_projects : Obtener proyectos en la organización
    • Entradas opcionales:
      • teamId (cadena): Filtrar proyectos por equipo
      • includeArchived (booleano): incluye proyectos archivados
      • limit (número, predeterminado: 50): número máximo de proyectos a devolver
      • status (cadena): Filtrar por estado del proyecto
  2. linear_get_project : Obtener detalles sobre un proyecto específico
    • Entradas requeridas:
      • projectId (cadena): ID del proyecto del que se obtendrán detalles
    • Devuelve información detallada del proyecto, incluido el progreso, el estado, el equipo, el líder y las fechas.
  3. linear_get_project_issues : Obtener problemas para un proyecto específico
  • Entradas requeridas:
    • projectId (cadena): ID del proyecto para el que se obtendrán los problemas
  • Entradas opcionales:
    • includeArchived (booleano): incluye problemas archivados
    • limit (número, predeterminado: 50): número máximo de problemas a devolver
    • status (cadena): Filtrar por estado del problema
    • priority (número): Filtrar por nivel de prioridad
Herramientas relacionadas con problemas
  1. linear_create_issue : Crea un nuevo problema lineal
  • Entradas requeridas:
    • title (cadena): Título del problema
    • teamId (cadena): ID del equipo en el que se creará el problema
  • Entradas opcionales:
    • description (cadena): Descripción del problema (compatible con Markdown)
    • priority (número, 0-4): Nivel de prioridad (1=urgente, 4=baja)
    • status (cadena): nombre del estado inicial
  1. linear_update_issue : Actualizar problemas existentes
  • Entradas requeridas:
    • id (cadena): ID del problema a actualizar
  • Entradas opcionales:
    • title (cadena): Nuevo título
    • description (cadena): Nueva descripción
    • priority (número, 0-4): Nueva prioridad
    • status (cadena): nuevo nombre de estado
  1. linear_search_issues : Problemas de búsqueda con filtrado flexible
  • Entradas opcionales:
    • query (cadena): Texto a buscar en el título/descripción
    • teamId (cadena): Filtrar por equipo
    • status (cadena): Filtrar por estado
    • assigneeId (cadena): Filtrar por cesionario
    • labels (string[]): Filtrar por etiquetas
    • priority (número): Filtrar por prioridad
    • limit (número, predeterminado: 10): Máximo de resultados
  1. linear_add_comment : Agregar comentarios a los problemas
  • Entradas requeridas:
    • issueId (cadena): ID del problema sobre el que se realizará el comentario
    • body (cadena): Texto del comentario (compatible con Markdown)
  • Entradas opcionales:
    • createAsUser (cadena): nombre de usuario personalizado
    • displayIconUrl (cadena): URL de avatar personalizada
Herramientas de gestión de etiquetas
  1. linear_get_labels : Obtener etiquetas en la organización
  • Entradas opcionales:
    • teamId (cadena): Filtrar etiquetas por equipo
    • includeArchived (booleano): incluye etiquetas archivadas
    • limit (número, predeterminado: 50): Número máximo de etiquetas a devolver
  1. linear_create_label : Crea una nueva etiqueta
  • Entradas requeridas:
    • name (cadena): nombre de la etiqueta
    • teamId (cadena): ID del equipo en el que se creará la etiqueta
  • Entradas opcionales:
    • color (cadena): código hexadecimal de color (p. ej., "#FF0000")
    • description (cadena): Descripción de la etiqueta
  1. linear_update_label : Actualizar una etiqueta existente
  • Entradas requeridas:
    • id (cadena): ID de etiqueta a actualizar
  • Entradas opcionales:
    • name (cadena): nuevo nombre de etiqueta
    • color (cadena): Nuevo código hexadecimal de color
    • description (cadena): Nueva descripción
Herramientas de gestión de archivos adjuntos
  1. linear_add_attachment : Agregar un archivo adjunto a un problema
  • Entradas requeridas:
    • issueId (cadena): ID del problema al que se agregará el archivo adjunto
    • url (cadena): URL del archivo adjunto
    • title (cadena): Título del archivo adjunto
  • Entradas opcionales:
    • subtitle (cadena): subtítulo para el archivo adjunto
    • icon (cadena): URL del icono para adjuntar
  1. linear_get_attachments : Obtener archivos adjuntos para un problema
  • Entradas requeridas:
    • issueId (cadena): ID del problema para el que se obtendrán los archivos adjuntos
Herramientas de relación de problemas
  1. linear_link_issues : Crea una relación entre problemas
  • Entradas requeridas:
    • issueId (cadena): ID del problema de origen
    • relatedIssueId (cadena): ID del problema de destino
    • type (cadena): Tipo de relación (por ejemplo, "bloques", "relacionado", "duplicado")
  1. linear_get_issue_relations : Obtener relaciones para un problema
  • Entradas requeridas:
    • issueId (cadena): ID del problema para obtener las relaciones
  • Entradas opcionales:
    • type (cadena): Filtrar por tipo de relación
Herramientas de gestión de hitos
  1. linear_get_milestones : Obtener hitos para un proyecto
  • Entradas opcionales:
    • projectId (cadena): Filtrar hitos por proyecto
    • includeArchived (booleano): incluye hitos archivados
    • limit (número, predeterminado: 50): número máximo de hitos a devolver
  1. linear_create_milestone : Crea un nuevo hito
  • Entradas requeridas:
    • name (cadena): nombre del hito
    • projectId (cadena): ID del proyecto para crear el hito en
    • targetDate (cadena): Fecha de finalización del objetivo (formato ISO)
  • Entradas opcionales:
    • description (cadena): Descripción del hito
    • sortOrder (número): Posición en la lista de hitos
  1. linear_update_milestone : Actualizar un hito existente
  • Entradas requeridas:
    • id (cadena): ID del hito a actualizar
  • Entradas opcionales:
    • name (cadena): nombre del nuevo hito
    • targetDate (cadena): Nueva fecha objetivo
    • description (cadena): Nueva descripción
    • status (cadena): Nuevo estado (por ejemplo, "planificado", "en progreso", "completado")

Recursos

  • linear-issue:///{issueId} : Ver detalles de problemas individuales
    • Devuelve información del problema, incluido el título, la descripción, los comentarios y los metadatos.
  • linear-team:///{teamId} : Ver detalles del equipo
    • Devuelve información del equipo, incluido nombre, clave, descripción y miembros.
  • linear-team:///{teamId}/issues : Ver problemas del equipo
    • Devuelve todos los problemas de un equipo específico con información de estado y prioridad.
  • linear-project:///{projectId} : Ver detalles del proyecto
    • Devuelve información del proyecto, incluido el nombre, la descripción, el progreso, el estado, el líder, los equipos y los cronogramas.
  • linear-project:///{projectId}/issues : Ver problemas del proyecto
    • Devuelve todos los problemas de un proyecto específico con información de estado y asignación
  • linear-project:///{projectId}/milestones : Ver los hitos del proyecto
    • Devuelve todos los hitos de un proyecto específico con información de progreso y estado.
  • linear-user:///{userId}/assigned : Ver los problemas asignados al usuario
    • Devuelve problemas asignados a un usuario específico con contexto de proyecto y equipo
  • linear-organization: : Ver información de la organización
    • Devuelve información a nivel de organización, incluido el nombre y la configuración.
  • linear-viewer: : Ver el contexto actual del usuario
    • Devuelve información sobre el usuario autenticado
  • linear-viewer:///teams : Ver equipos para el usuario autenticado
    • Devuelve todos los equipos de los que es miembro el usuario actual
  • linear-viewer:///projects : Ver proyectos para el usuario autenticado
    • Devuelve todos los proyectos en los que está involucrado el usuario actual (como líder o miembro)
  • linear-viewer:///assigned : Ver los problemas asignados al usuario autenticado
    • Devuelve todos los problemas asignados al usuario actual con el contexto del proyecto y del equipo.
  • linear-label:///{labelId} : Ver detalles de la etiqueta
    • Devuelve información de la etiqueta, incluido el nombre, el color y los problemas asociados.

Ejemplos de uso

A continuación se muestran ejemplos de indicaciones que puede utilizar con Claude Desktop para interactuar con Linear:

Gestión de problemas

  • "Crear un nuevo informe de error para el sistema de autenticación" → utilice linear_create_issue para crear un nuevo problema con los detalles apropiados
  • "Actualizar la prioridad del ticket FRONT-123 a urgente" → utilice linear_update_issue para modificar la prioridad de un problema existente
  • "Agregar un comentario al error de la página de inicio de sesión explicando la causa raíz" → use linear_add_comment para agregar información a un problema existente

Encontrar y filtrar problemas

  • "Muéstrame todos mis problemas de alta prioridad" → usa linear_get_user_issues o linear-viewer:///assigned para encontrar problemas asignados a ti con alta prioridad
  • "Buscar todas las tareas de frontend en curso" → use linear_search_issues para localizar problemas relacionados con el frontend con estado "en curso".
  • "¿Qué problemas tiene asignados Sarah actualmente?" → usa linear_get_user_issues con el ID de Sarah para ver sus tareas.

Gestión de equipos y proyectos

  • "¿De qué equipos soy miembro?" → use linear_get_user_teams o linear-viewer:///teams para listar todos los equipos a los que pertenece el usuario autenticado
  • "Muéstrame los proyectos que estoy liderando o a los que contribuyo" → usa linear_get_user_projects o linear-viewer:///projects para obtener todos los proyectos asociados con el usuario actual
  • "¿Cuál es el progreso actual del proyecto de la aplicación móvil?" → Use linear_get_project para obtener información detallada sobre el proyecto, incluido el progreso.
  • "Enumerar todos los proyectos activos del equipo de Frontend" → combinar linear_get_team para encontrar el ID del equipo y linear_get_projects con el filtro de equipo para localizar proyectos activos

Análisis del estado y la carga de trabajo

  • "Proporcione un resumen de las actualizaciones recientes sobre los problemas del sistema de facturación" → utilice linear_search_issues para identificar los problemas relevantes y, luego, linear-issue:///{issueId} para obtener los detalles del problema.
  • "¿Cuál es la carga de trabajo actual del equipo móvil?" → Use linear-team:///{teamId}/issues o linear_get_team_issues para analizar la distribución de problemas en el equipo.
  • "Muéstrame mi rol y responsabilidades en la organización" → usa linear_get_viewer y linear-viewer:///teams para analizar las membresías y roles del equipo

Etiqueta y categorización

  • "Crear una etiqueta de 'seguridad' para problemas de seguridad de alta prioridad" → usar linear_create_label para crear una nueva etiqueta con la configuración adecuada
  • "¿Qué etiquetas están disponibles en el equipo de frontend?" → Use linear_get_labels con el ID del equipo de frontend para ver las categorizaciones disponibles.
  • "Aplicar la etiqueta 'necesita documentación' a todos los problemas de la API" → usar linear_search_issues para encontrar problemas relacionados con la API y luego actualizar cada uno con linear_update_issue

Gestión de hitos

  • "Crear un hito para la versión beta" → use linear_create_milestone para establecer un hito del proyecto con una fecha objetivo
  • "¿Qué hitos se avecinan en el proyecto de la aplicación móvil?" → Use linear_get_milestones con el ID del proyecto para ver los puntos de entrega planificados.
  • "Actualizar el estado del hito de la API v2 a completado" → usar linear_update_milestone para cambiar el estado del hito

Relaciones de problemas

  • "Marcar el problema FRONT-123 como API-456 de bloqueo" → usar linear_link_issues para crear una relación de bloqueo entre problemas
  • "¿Qué problemas están siendo bloqueados por este error?" → usar linear_get_issue_relations para encontrar dependencias
  • "Muéstrame todos los problemas relacionados con el sistema de autenticación" → usa linear_search_issues con los filtros adecuados y luego explora las relaciones con linear_get_issue_relations

Desarrollo

  1. Instalar dependencias:
npm install
  1. Configurar la clave API lineal en .env :
LINEAR_API_KEY=your_api_key_here
  1. Construir el servidor:
npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor de protocolo de contexto de modelo que permite que grandes modelos de lenguaje interactúen con el sistema de seguimiento de problemas de Linear, lo que permite la gestión de problemas, proyectos, equipos y otros recursos de Linear.

  1. Instalación
    1. Instalación automática
    2. Instalación manual
  2. Componentes
    1. Herramientas
    2. Recursos
  3. Ejemplos de uso
    1. Gestión de problemas
    2. Encontrar y filtrar problemas
    3. Gestión de equipos y proyectos
    4. Análisis del estado y la carga de trabajo
    5. Etiqueta y categorización
    6. Gestión de hitos
    7. Relaciones de problemas
  4. Desarrollo
    1. Licencia

      Related MCP Servers

      • -
        security
        A
        license
        -
        quality
        A Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.
        Last updated 5 days ago
        324
        288
        JavaScript
        MIT License
        • Apple
      • -
        security
        A
        license
        -
        quality
        A Model Context Protocol server that allows Claude to interact with Linear's API for managing teams, issues, projects, and cycles.
        Last updated 2 months ago
        15
        1
        TypeScript
        MIT License
      • A
        security
        A
        license
        A
        quality
        A Model Context Protocol server that integrates with Linear, enabling AI assistants to create, update, search, and comment on issues for project management and issue tracking.
        Last updated a month ago
        5
        6
        Python
        Apache 2.0
      • -
        security
        -
        license
        -
        quality
        A Model Context Protocol server implementation that enables AI assistants to interact with Linear project management systems, allowing them to create, retrieve, and modify data related to issues, projects, teams, and users.
        Last updated 2 months ago
        20
        2
        TypeScript

      View all related MCP servers

      ID: hb4oc9s50d