Linear MCP Server logo

Linear MCP Server

by cpropster

This is a Model Context Protocol (MCP) server for Linear. It allows Claude to interact with Linear's API to manage teams, issues, projects, and cycles.

View on GitHub

Last updated: N/A

What is Linear MCP Server?

The Linear MCP Server is an integration that allows AI models like Claude to interact with the Linear API. It provides tools for managing teams, issues, projects, and cycles within Linear.

How to use Linear MCP Server?

To use the server, install it through the Cline MCP Marketplace or manually by cloning the repository, installing dependencies, and building the server. Configure your Linear OAuth token in the MCP configuration file. Then, use the provided tools (e.g., linear_search_issues, linear_get_teams) with the use_mcp_tool function, providing the server name and necessary arguments.

Key features of Linear MCP Server

  • linear_get_teams: Get all teams with their states and labels

  • linear_search_issues: Search for 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

  • Automating issue creation based on AI analysis

  • Retrieving project status updates for reporting

  • Managing team assignments and workflows

  • Searching for specific issues based on keywords or criteria

FAQ from Linear MCP Server

How do I get a Linear OAuth token?

Create a Linear OAuth application at https://linear.app/settings/api/applications. Set the redirect URI to http://localhost:3000/callback and create and copy a USER based developer token.

How do I configure the MCP server?

Add the server configuration to your MCP configuration file, including your Linear OAuth token and other credentials.

How do I verify the installation?

Reload the MCP configuration and test the connection by using the linear_search_issues tool.

What do I do if the connection is not working?

Check your MCP configuration, Linear API status, and server logs. Ensure your Linear tokens are valid and that the server is enabled in the configuration.

How do I update an existing issue?

Use the linear_update_issue tool with the required issueId and the fields you want to update.