Linear MCP Server

What is Linear MCP Server?

Linear MCP Server is a Model Context Protocol server that enables Claude to interact with Linear’s API to manage teams, issues, projects, and cycles.

How to use Linear MCP Server?

Install the server via the Cline MCP Marketplace or clone and build from source. Configure a Linear OAuth token in the MCP configuration file, then verify the connection by using the linear_search_issues tool.

Key features of Linear MCP Server

• linear_get_teams – retrieve all teams with states and labels
• linear_search_issues – search issues with filtering and pagination
• linear_get_cycles – get all cycles for a team
• linear_get_projects – get all projects
• linear_create_issue – create a new issue
• linear_update_issue – update an existing issue

Use cases of Linear MCP Server

• Manage Linear issues directly from Claude conversations
• Retrieve team data, cycles, and projects for planning
• Create and update issues without leaving the chat interface

FAQ from Linear MCP Server

What dependencies are required?

Node.js and npm are required. After cloning the repository, run npm install and npm run build.

How do I authenticate with Linear?

Create a Linear OAuth application at linear.app, note the client ID, client secret, and generate a user-based developer token. Provide these as environment variables (LINEAR_CLIENT_ID, LINEAR_CLIENT_SECRET, LINEAR_REFRESH_TOKEN) in the MCP configuration file.

How do I verify the installation is working?

After configuring the MCP server, reload the configuration and test with the linear_search_issues tool. A successful response lists issues from your Linear account.

What are common issues during setup?

Common issues include an incorrect server path in the args field, invalid or expired Linear tokens, missing required environment variables, or the server being disabled in the configuration.