# Linear MCP — Project Management for Claude Code & Cursor

> Linear's official MCP lets Claude Code, Cursor, Codex CLI manage Linear issues, projects, cycles. Search by status, create issues from chat, link PRs.

## Install

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

## Quick Use

1. Add the JSON snippet below to your MCP config (`~/.claude/mcp.json` or equivalent)
2. Restart your MCP host
3. First Linear tool call triggers OAuth — authorize in browser, token cached locally

---

## Intro

Linear's official MCP server exposes Linear's API as Model Context Protocol tools — search issues, create / update / comment, manage cycles and projects, link GitHub PRs. Configure once, every MCP-aware host (Claude Code, Cursor, Codex CLI, Cline) can manage your Linear workspace. Best for: engineering teams who want to triage / create / update Linear issues without leaving their AI coding tool. Works with: any MCP host. Setup time: 3 minutes.

---

### MCP config

```json
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/sse"]
    }
  }
}
```

The first time you use a Linear tool, your browser opens to authorize the MCP via Linear OAuth. Token is stored locally.

### Tools exposed

| Tool | Use |
|---|---|
| `linear_list_issues` | Filter by status, assignee, project, labels |
| `linear_get_issue` | Full issue with comments, attachments, history |
| `linear_create_issue` | Create with team, priority, assignee, labels |
| `linear_update_issue` | Change status, assignee, body |
| `linear_create_comment` | Comment on issue or PR-linked issue |
| `linear_list_projects` | Projects with progress, due dates |
| `linear_list_cycles` | Active and upcoming cycles |
| `linear_search` | Full-text search across issues |

### Common prompts

```
> Show me all P0 issues assigned to me, sorted by created date

> Create a Linear issue: "Auth flow drops state on redirect" in #web team,
  priority urgent, assign to @me, attach the failing test from this file

> Comment on ENG-1234: "Reproduced — root cause is missing CSRF token. PR up tonight."
```

### Auth and rate limits

- OAuth token has the same scopes as your Linear account — read what you can read, write what you can write
- Rate limit: 1,000 requests/hour per user (Linear's standard API limit)
- For team-shared usage, generate a Linear personal API key with restricted scopes via Settings → API instead of OAuth

---

### FAQ

**Q: Is Linear MCP free?**
A: Yes — the MCP server is free and official. You only need a Linear account (Linear has a free tier for ≤10 users). The MCP wraps Linear's existing API; it doesn't add billing.

**Q: Does this support Linear's webhooks?**
A: No — webhooks are server-to-server. Linear MCP is for client-driven actions (your AI agent reading and writing). For event-driven workflows, set up Linear webhooks separately and route them into Inngest / Trigger.dev.

**Q: Can my agent only see issues I have access to?**
A: Yes — OAuth scopes match your account. The MCP cannot escalate to issues outside your visibility. For finer-grained control, generate a scoped API key via Linear's settings.

---

## Source & Thanks

> Built by [Linear](https://github.com/linear). Commercial product with free tier.
>
> [linear.app/docs/mcp](https://linear.app/docs/mcp) — Official MCP documentation

---

<!-- ZH -->

## 快速使用

1. 把下面的 JSON 加到 MCP 配置（`~/.claude/mcp.json` 或等效位置）
2. 重启 MCP 宿主
3. 第一次调 Linear 工具触发 OAuth，浏览器授权后 token 本地缓存

---

## 简介

Linear 官方 MCP server 把 Linear API 暴露成 Model Context Protocol 工具 —— 搜 issue、创建/更新/评论、管理 cycle 和 project、关联 GitHub PR。配一次，所有 MCP 宿主（Claude Code / Cursor / Codex CLI / Cline）都能管你的 Linear workspace。适合不想离开 AI 编码工具就处理 / 创建 / 更新 Linear issue 的工程团队。兼容任何 MCP 宿主。装机时间 3 分钟。

---

### MCP 配置

```json
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/sse"]
    }
  }
}
```

第一次用 Linear 工具时浏览器打开做 Linear OAuth 授权。token 本地存。

### 暴露的工具

| 工具 | 用途 |
|---|---|
| `linear_list_issues` | 按状态 / 负责人 / project / label 过滤 |
| `linear_get_issue` | 完整 issue 含评论、附件、历史 |
| `linear_create_issue` | 带团队、优先级、负责人、label 创建 |
| `linear_update_issue` | 改状态、负责人、正文 |
| `linear_create_comment` | 给 issue 或关联 PR 的 issue 评论 |
| `linear_list_projects` | Project 含进度、截止日期 |
| `linear_list_cycles` | 活跃和即将到来的 cycle |
| `linear_search` | 跨 issue 全文搜索 |

### 常见 prompt

```
> Show me all P0 issues assigned to me, sorted by created date

> Create a Linear issue: "Auth flow drops state on redirect" in #web team,
  priority urgent, assign to @me, attach the failing test from this file

> Comment on ENG-1234: "Reproduced — root cause is missing CSRF token. PR up tonight."
```

### 鉴权和限速

- OAuth token 有跟你 Linear 账号一样的 scope —— 你能读啥就读啥，能写啥就写啥
- 限速：每用户每小时 1000 请求（Linear 标准 API 限制）
- 团队共享用法不要用 OAuth，去 Settings → API 生成限定 scope 的 Linear personal API key

---

### FAQ

**Q: Linear MCP 免费吗？**
A: 免费 —— MCP server 免费且官方。你只需要 Linear 账号（Linear ≤10 用户有免费档）。MCP 包装 Linear 已有 API，不另外计费。

**Q: 支持 Linear 的 webhook 吗？**
A: 不支持 —— webhook 是服务器到服务器的。Linear MCP 是客户端驱动的动作（你的 AI agent 读写）。事件驱动工作流另外配 Linear webhook 路由到 Inngest / Trigger.dev。

**Q: 我的 agent 只能看到我有权限的 issue 吗？**
A: 对 —— OAuth scope 跟你的账号匹配。MCP 不能提权访问你看不到的 issue。要更细粒度控制就在 Linear 设置生成限定 scope 的 API key。

---

## 来源与感谢

> Built by [Linear](https://github.com/linear). Commercial product with free tier.
>
> [linear.app/docs/mcp](https://linear.app/docs/mcp) — Official MCP documentation


---
Source: https://tokrepo.com/en/workflows/linear-mcp-project-management-for-claude-code-cursor
Author: Linear