Linear MCP Server

Name: Linear MCP Server
Author: cpropster

@cpropster

Repository

About Linear MCP Server

MCP server for Linear integration

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "linear-mcp-server-cpropster": {
      "command": "node",
      "args": [
        "test-client.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Linear MCP Server?

Linear MCP Server is a Model Context Protocol (MCP) server that allows Claude and other MCP clients to interact with Linear’s API. It enables management of teams, issues, projects, and cycles directly from an AI assistant.

How to use Linear MCP Server?

Clone the repository, install dependencies with npm install, and build with npm run build. Configure your Linear OAuth token and other credentials in the MCP configuration file under the server’s env section. Verify the installation by using the linear_search_issues tool to test the connection.

Key features of Linear MCP Server

Retrieve all teams with their states and labels
Search for issues with filtering and pagination
Get all cycles for a team
Get all projects
Create a new issue
Update an existing issue

Use cases of Linear MCP Server

List and search your Linear issues from an AI chat
Create new issues with custom title, description, priority, and assignee
Update existing issues (change status, priority, assignee, etc.)
View team cycles and projects for planning
Automate common Linear workflows via natural language

FAQ from Linear MCP Server

What tools does Linear MCP Server provide?

It provides six tools: linear_get_teams, linear_search_issues, linear_get_cycles, linear_get_projects, linear_create_issue, and linear_update_issue.

How do I authenticate with Linear?

You need a Linear OAuth token. Create a Linear OAuth application at https://linear.app/settings/api/applications, get a developer token, and set LINEAR_CLIENT_ID, LINEAR_CLIENT_SECRET, LINEAR_REDIRECT_URI, and LINEAR_REFRESH_TOKEN in the MCP configuration environment.

How do I verify the server is working?

After configuration, run the linear_search_issues tool. If successful, it returns a list of issues from your Linear account. You can also run the included test client with node test-client.js.

What are common installation issues?

Common problems include incorrect server path in the MCP config, invalid or expired Linear tokens, missing required environment variables, or the server being disabled in the configuration.

What are the security considerations?

Never commit tokens to version control. Use environment variables instead of hardcoding. Limit permissions on the OAuth application and rotate tokens periodically. All communication with Linear occurs over HTTPS.

Comments

More Version Control MCP servers

MCP Linear

tacticlaunch

MCP server that enables AI assistants to interact with Linear project management system through natural language, allowing users to retrieve, create, and update issues, projects, and teams.

141