MCP-linear-Server

The Linear MCP Integration Server is designed to facilitate seamless interaction between AI models and the Linear platform, which is widely used for issue tracking and project management. By leveraging the Model Context Protocol (MCP), this server allows for efficient management of tasks, issues, and projects within Linear. It supports a variety of operations such as creating issues, searching for issues, managing sprints, and retrieving workflow states. The server is built with TypeScript and utilizes the Linear SDK for API interactions, ensuring robust error handling, rate limiting, and connection management. It also supports automatic reconnection and heartbeat monitoring to maintain connection health. The server can be deployed using Docker for ease of setup and scalability, making it a versatile tool for developers looking to integrate Linear functionalities into their applications.

Features

• {'name': 'linear_create_issue', 'description': 'Creates a new Linear issue with parameters like title, teamId, description, priority, and status.'}
• {'name': 'linear_search_issues', 'description': 'Searches Linear issues with flexible filtering options such as query, team, status, assignee, and priority.'}
• {'name': 'linear_sprint_issues', 'description': 'Retrieves all issues in the current sprint/iteration for a specific team.'}
• {'name': 'linear_search_teams', 'description': 'Searches and retrieves Linear teams by name.'}
• {'name': 'linear_get_workflow_states', 'description': 'Gets all available workflow states (statuses) for a specific team.'}

MCP Tools

• linear_create_issue: Tool to create a new issue in Linear.
• linear_search_issues: Tool to search for issues in Linear with various filters.
• linear_sprint_issues: Tool to get issues in the current sprint for a team.
• linear_search_teams: Tool to search for teams in Linear.
• linear_get_workflow_states: Tool to get workflow states for a team in Linear.

Usage with Different Platforms

Docker

bash
docker-compose up -d

Cursor

bash
env LINEAR_API_KEY=your_linear_api_key node /path/to/your/mcp-linear-server/dist/server.js