# Linear Issue MCP

An MCP (Model Context Protocol) server for Linear. Use it from Claude Desktop or any MCP client to create, search, update, and comment on Linear issues.

## Requirements

- Node.js 18+
- A Linear API key ([team settings → API](https://linear.app/YOUR-TEAM/settings/api))

## Setup

```bash
git clone https://github.com/aniketsharma/linear-issue-mcp.git
cd linear-issue-mcp
npm install
npm run build
```

Create a `.env` file (or set the variable in your MCP client config):

```bash
LINEAR_API_KEY=your_api_key_here
```

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):

```json
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "linear-issue-mcp"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}
```

For local development without publishing, point `command` at `node` and `args` at the built entry:

```json
{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/absolute/path/to/linear-issue-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}
```

## Tools

| Tool | Purpose |
|------|---------|
| `linear_create_issue` | Create an issue (`title`, `teamId`; optional description, priority, status) |
| `linear_update_issue` | Update an issue by `id` |
| `linear_search_issues` | Filter by query, team, status, assignee, labels, priority |
| `linear_get_user_issues` | List issues for a user (or the authenticated user) |
| `linear_add_comment` | Comment on an issue (markdown supported) |

## Resources

- `linear-issue:///{issueId}` — single issue
- `linear-team:///{teamId}/issues` — team backlog
- `linear-user:///{userId}/assigned` — assigned issues (`me` for current user)
- `linear-organization:` — org, teams, members
- `linear-viewer:` — authenticated user context

## Example prompts

- “Show my high-priority Linear issues”
- “Create a bug report for the auth flow and assign it to the mobile team”
- “Summarize recent updates on frontend issues that are in progress”

## Development

```bash
npm install
npm run build
npm run watch   # rebuild on change
npm run inspector
```

## License

MIT — see [LICENSE](LICENSE).