Linear MCP Integration Server

What is Linear MCP Integration Server?

This server connects AI models to Linear for issue tracking and project management through the Model Context Protocol (MCP). It provides tools to create, search, and update issues, manage sprints, and handle cycles.

How to use Linear MCP Integration Server?

Obtain a Linear API key from Linear settings, create a .env file with LINEAR_API_KEY, install dependencies (npm install), and start the server (npm start or npm run dev). Tools are accessed via MCP and include issue creation, search, sprint issue retrieval, team search, status updates, and cycle management.

Key features of Linear MCP Integration Server

• Creates, searches, and retrieves Linear issues with filtering and pagination
• Manages sprint issues and bulk updates statuses
• Creates and updates cycles (sprints) with start/end dates
• In-memory caching with configurable TTL and automatic cleanup
• Automatic reconnection and heartbeat monitoring for connection health
• Batch processing and pagination for large result sets

Use cases of Linear MCP Integration Server

• An AI assistant creating and assigning issues based on user prompts
• A developer querying current sprint issues during standups
• A project manager bulk-updating issue statuses after a release
• A team automating cycle creation and tracking from external events
• An analyst searching across teams and priorities to generate reports

FAQ from Linear MCP Integration Server

What prerequisites are needed to run this server?

You need a Linear API key from your Linear account settings and a .env file containing LINEAR_API_KEY.

Does the server support pagination for large result sets?

Yes, all search tools support cursor-based pagination with configurable limits and sort options.

Can this server be deployed on Smithery.ai?

Yes, it includes a Dockerfile and smithery.yaml configuration for deployment on Smithery with your Linear API key.

What happens if the connection to the Linear API is lost?

The server automatically reconnects with configurable retry attempts and uses heartbeat monitoring to maintain connection health.