Integrations
Used for environment variable management, specifically to load the Linear API key for authentication with Linear's API.
Provides tools for interacting with Linear for issue tracking and project management, including creating issues, searching issues, retrieving sprint issues, searching teams, filtering sprint issues, and bulk updating issue statuses.
Supported in Linear issue descriptions, allowing rich text formatting when creating issues.
Linear MCP Integration Server
This server provides Linear integration capabilities through the Model Context Protocol (MCP). It allows AI models to interact with Linear for issue tracking and project management.
Features
The server provides the following tools through the MCP interface:
linear_create_issue
Creates a new Linear issue with the following parameters:
title
(required): Issue titleteamId
(required): Team ID to create issue indescription
(optional): Issue description (markdown supported)priority
(optional): Priority level (0-4)status
(optional): Initial status name
linear_search_issues
Search Linear issues with flexible filtering and pagination support:
query
(optional): Text to search in title/descriptionteamId
(optional): Filter by teamstatus
(optional): Filter by statusassigneeId
(optional): Filter by assigneepriority
(optional): Priority level (0-4)limit
(optional, default: 10): Max results per pagecursor
(optional): Pagination cursor for fetching next pagesortBy
(optional, default: 'updated'): Field to sort by ('created', 'updated', 'priority', 'title')sortDirection
(optional, default: 'desc'): Sort direction ('asc', 'desc')
linear_sprint_issues
Get all issues in the current sprint/iteration:
teamId
(required): Team ID to get sprint issues for
linear_search_teams
Search and retrieve Linear teams:
query
(optional): Text to search in team names
linear_filter_sprint_issues
Filter current sprint issues by status and automatically filters to the current user:
teamId
(required): Team ID to get sprint issues forstatus
(required): Status to filter by (e.g. "Pending Prod Release")
linear_get_issue_details
Get detailed information about a specific issue, including full description, comments, and metadata:
issueId
(required): Issue ID (e.g., "DATA-1284") to fetch details for
linear_bulk_update_status
Update the status of multiple Linear issues at once:
issueIds
(required): List of issue IDs to update (e.g. ["ENG-123", "DATA-456"])targetStatus
(required): Target status to set for all issues (e.g. "In Progress")
linear_manage_cycle
Create, update, or get information about Linear cycles (sprints):
action
(required): Action to perform: "create", "update", "get", or "list"teamId
(required): Team ID to manage cycles forcycleId
(optional, required for update and get actions): Cycle IDname
(optional, required for create): Cycle namestartDate
(optional, required for create): Start date in ISO format (YYYY-MM-DD)endDate
(optional, required for create): End date in ISO format (YYYY-MM-DD)description
(optional): Cycle description
Developer Setup
- Get your Linear API key from Linear's settings > API section
- Create a
.env
file in the project root:
- Install dependencies:
- Start the server:
Technical Details
- Built with TypeScript and the Model Context Protocol SDK
- Uses Linear SDK for API interactions
- Includes error handling, rate limiting, and connection management
- Supports automatic reconnection with configurable retry attempts
- Implements heartbeat monitoring for connection health
- Provides detailed logging in debug mode
- Features an in-memory caching system for improved performance
- Supports pagination for handling large result sets
- Implements batch processing for bulk operations
Performance and Reliability
The server includes comprehensive features for performance and reliability:
Caching System
- In-memory caching for frequently accessed data (teams, workflow states)
- Configurable TTL (Time To Live) for cache entries
- Automatic cleanup of expired cache entries
- Cache statistics available in debug mode
Error Handling
- API timeout protection with configurable timeouts
- Automatic reconnection attempts on connection loss
- Detailed error logging with timestamps and context
- Graceful shutdown handling with cleanup
- Heartbeat monitoring for connection health
Performance Optimizations
- Batch processing for bulk operations
- Pagination support for large result sets
- Parallel processing with Promise.all for concurrent operations
- Efficient data fetching with minimal API calls
Dependencies
@linear/sdk
: Linear API client@modelcontextprotocol/sdk
: MCP server implementationzod
: Runtime type checking and validationdotenv
: Environment variable management- TypeScript and related development tools
For the complete list of dependencies, see package.json
.
Smithery Deployment
This server can be deployed on Smithery.ai using the provided configuration files:
Prerequisites
- A Smithery.ai account
- Your Linear API key
Deployment Steps
- Add this repository to Smithery or claim an existing server
- Access the Deployments tab (authenticated owners only)
- Configure the deployment with your Linear API key
- Deploy the server
Configuration Files
The repository includes two essential files for Smithery deployment:
- Dockerfile: Defines the server build process
- Uses Node.js 18 Alpine as the base image
- Installs dependencies and builds the TypeScript code
- Sets up the command to run the server
- smithery.yaml: Defines the server startup configuration
- Specifies the command to run the server
- Defines the required configuration parameters (Linear API key)
- Handles environment variable setup
Testing Locally
You can test the Smithery configuration locally using the MCP Inspector:
This server cannot be installed
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.
Enables AI models to interact with Linear for issue tracking and project management through the Model Context Protocol, supporting capabilities like creating issues, searching, managing sprints, and bulk updating statuses.
Related MCP Servers
- AsecurityAlicenseAqualityEnables AI agents to manage issues, projects, and teams on the Linear platform programmatically.Last updated -712322JavaScriptMIT License
- -securityFlicense-qualityEnables AI models to interact with Linear for issue tracking and project management through capabilities like creating/searching issues, managing sprints, and retrieving workflow states.Last updated -TypeScript
- AsecurityAlicenseAqualityA 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 -56PythonApache 2.0
- AsecurityAlicenseAqualityProvides tools for interacting with Targetprocess, a project management and agile planning platform, enabling AI assistants to search, create, and update project entities with proper validation.Last updated -5TypeScriptMIT License