Linear MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Integrates with Linear's GraphQL API to provide access to Linear's data model and functionality for issue tracking and project management.

  • Enables interaction with Linear's issue tracking system, allowing creation, updating, and searching of issues, adding comments, and viewing issue details across teams and users.

  • Supports markdown formatting in issue descriptions and comments when creating or updating Linear issues.

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 linear-mcp-server --client claude

Instalación manual

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

Componentes

Herramientas

  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
  2. 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
  3. 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
  4. 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
  5. 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

Recursos

  • linear-issue:///{issueId} - Ver detalles de problemas individuales
  • linear-team:///{teamId}/issues - Ver problemas del equipo
  • linear-user:///{userId}/assigned - Ver los problemas asignados al usuario
  • linear-organization: - Ver información de la organización
  • linear-viewer: - Ver el contexto actual del usuario

Ejemplos de uso

Algunos ejemplos de indicaciones que puedes usar con Claude Desktop para interactuar con Linear:

  1. "Muéstrame todos mis problemas de alta prioridad " → ejecuta la herramienta search_issues y/o linear-user:///{userId}/assigned para encontrar los problemas que te fueron asignados con prioridad 1
  2. "Con base en lo que ya le comenté sobre este error, cree un informe de error para el sistema de autenticación" → use create_issue para crear un nuevo problema de alta prioridad con los detalles apropiados y el seguimiento del estado
  3. "Buscar todas las tareas de frontend en curso" → use search_issues para localizar problemas relacionados con el frontend con la tarea en curso
  4. "Brinde un resumen de las actualizaciones recientes sobre los problemas para el desarrollo de aplicaciones móviles" → use search_issues para identificar los problemas relevantes, luego, linear-issue:///{issueId} obtenga los detalles del problema y muestre la actividad y los comentarios recientes.
  5. "¿Cuál es la carga de trabajo actual del equipo móvil?" → Combine linear-team:///{teamId}/issues y search_issues para analizar la distribución y las prioridades de los problemas en todo el equipo móvil.

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 se integra con el sistema de seguimiento de problemas de Linear, permitiendo a los LLM crear, actualizar, buscar y comentar problemas de Linear a través de interacciones en lenguaje natural.

  1. Installation
    1. Automatic Installation
    2. Manual Installation
  2. Components
    1. Tools
    2. Resources
  3. Usage examples
    1. Development
      1. License
        ID: 6nsgmb0z2y