Linear MCP Server

@cpropster

About Linear MCP Server

MCP server for Linear integration

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.

Frequently asked questions

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?

Comments

Basic information

More Version Control MCP servers

AIO-MCP Server

athapong

🚀 All-in-one MCP server with AI search, RAG, and multi-service integrations (GitLab/Jira/Confluence/YouTube) for AI-enhanced development workflows. Folk from https://github.com/nguyenvanduocit/all-in-one-model-context-protocol

Code Review Server

crazyrabbitLTC

A MCP server for code reviews

Atlassian Bitbucket MCP Server

aashari

Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get, comment, search). Connects AI directly to version control workflows through the standard MCP interface.

157

MCP GitHub Project Manager

kunwarVivek

a mcp server to manage github project's functionality

GitLab

modelcontextprotocol

Model Context Protocol Servers

88.1K