# Linear MCP — Project Management for AI Agents

> MCP server that connects AI agents to Linear for issue tracking, project management, and workflow automation. Create issues, update status, and query projects via natural language. 1,500+ stars.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

Add to your `.mcp.json`:

```json
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-linear"],
      "env": {
        "LINEAR_API_KEY": "lin_api_your_key_here"
      }
    }
  }
}
```

Get your API key at Linear > Settings > API. Restart Claude Code.

---

## Intro

Linear MCP is a Model Context Protocol server that connects AI agents like Claude Code to Linear project management with 1,500+ GitHub stars. Create issues, update status, assign team members, query backlogs, and automate workflows — all through natural language. Your AI agent becomes a project management assistant that knows your team's tasks and priorities. Best for engineering teams using Linear who want AI-assisted project tracking. Works with: Claude Code, Cursor, any MCP client. Setup time: under 2 minutes.

---

## Available Tools

### `linear_create_issue`
```
"Create a bug report: Login fails with expired JWT tokens. Priority: urgent. Assign to backend team."
```

### `linear_update_issue`
```
"Move issue LIN-423 to In Review and add a comment: Fix deployed to staging"
```

### `linear_search`
```
"Find all open bugs assigned to me"
"Show high-priority issues in the Authentication project"
```

### `linear_list_projects`
```
"List all active projects and their completion percentages"
```

### `linear_get_cycles`
```
"Show the current sprint and remaining issues"
```

## Use Cases

### Auto-Create Issues from Code
```
"I just found a race condition in the payment handler. Create a Linear issue with the code context."
→ Agent creates issue with file reference, stack trace, and suggested fix
```

### Sprint Review
```
"Summarize what was completed in the current cycle"
→ Agent queries completed issues and generates a summary
```

### Bug Triage
```
"Show all unassigned bugs from the last week, sorted by priority"
→ Agent queries and presents organized list
```

### Code-to-Issue Linking
```
"I just fixed LIN-423. Update the issue status to Done and link this commit."
```

### Key Stats
- 1,500+ GitHub stars
- Full CRUD for Linear issues
- Project and cycle queries
- Team and assignment management
- Webhook support for real-time updates

### FAQ

**Q: What is Linear MCP?**
A: An MCP server that gives AI agents full access to Linear project management — create issues, update status, query backlogs, and automate workflows via natural language.

**Q: Is Linear MCP free?**
A: The MCP server is open-source. Linear requires a subscription for teams.

**Q: Can it create issues from code context?**
A: Yes, the agent can reference files, line numbers, and error messages when creating issues.

---

## Source & Thanks

> Built on [Linear API](https://linear.app/docs/api). Licensed under MIT.
>
> [mcp-linear](https://github.com/anthropics/mcp-linear) — ⭐ 1,500+

Thanks for connecting AI agents to where the work gets tracked.

---

<!-- ZH -->

## 快速使用

将以下配置添加到 `.mcp.json`:

```json
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-linear"],
      "env": { "LINEAR_API_KEY": "lin_api_你的密钥" }
    }
  }
}
```

---

## 简介

Linear MCP 是一个将 AI Agent 连接到 Linear 项目管理的 MCP 服务器，GitHub 1,500+ stars。创建 issue、更新状态、查询待办和自动化工作流。适合使用 Linear 的工程团队。

---

## 来源与感谢

> Built on [Linear API](https://linear.app/docs/api). Licensed under MIT.
>
> [mcp-linear](https://github.com/anthropics/mcp-linear) — ⭐ 1,500+

---
Source: https://tokrepo.com/en/workflows/f2764bfd-1da0-46e2-ad28-253410abc920
Author: MCP Hub