Linear MCP Server

What is Linear MCP Server?

A Model Context Protocol (MCP) server that provides tools for interacting with Linear’s API, enabling AI agents to manage issues, projects, and teams programmatically through the Linear platform.

How to use Linear MCP Server?

Obtain a Linear API key from Linear’s Developer Settings, then run LINEAR_API_KEY=your-api-key npx @ibraheem4/linear-mcp. Alternatively, set the environment variable or configure the server in your client’s MCP settings (e.g., Claude Desktop, VS Code extension, Cursor) with the path to the built server and the API key in the env object.

Key features of Linear MCP Server

• Create, update, and list issues with filters
• List all teams in the workspace
• List projects with optional team filtering
• Retrieve detailed information about a specific issue
• Supports priorities, labels, and assignees

Use cases of Linear MCP Server

• Automate bug report creation from AI‑powered chat
• Query team‑assigned issues for status updates
• Update issue priority or assignee via natural language
• View project milestones and team details on demand

FAQ from Linear MCP Server

What prerequisites are required?

Node.js v16 or higher, a Linear account with API access, and a Linear API key.

How do I configure the server for my MCP client?

Add the server to your client’s MCP config file with the command node /path/to/build/index.js and set the LINEAR_API_KEY environment variable. Examples are provided for Claude Desktop, VS Code (Cline extension), and Cursor.

What tools does the server expose?

Six tools: create_issue, list_issues, update_issue, get_issue, list_teams, and list_projects. Each accepts typed parameters as documented.

How are errors handled?

The server includes comprehensive error handling for invalid API keys, missing parameters, Linear API errors, and invalid tool requests, returning descriptive error messages.