# Linear Mcp Server

> A server that integrates Linear's project management system with the Model Context Protocol (MCP) to allow LLMs to interact with Linear.

- **Type:** MCP server
- **Install:** `agentstack add mcp-jerhadf-linear-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jerhadf](https://agentstack.voostack.com/s/jerhadf)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jerhadf](https://github.com/jerhadf)
- **Source:** https://github.com/jerhadf/linear-mcp-server
- **Website:** https://smithery.ai/server/linear-mcp-server

## Install

```sh
agentstack add mcp-jerhadf-linear-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Linear MCP Server

[](https://www.npmjs.com/package/linear-mcp-server) [](https://smithery.ai/server/linear-mcp-server)

**IMPORTANT NOTE:** This MCP Server is now deprecated and is no longer being maintained. I recommend you use the official Linear remote MCP server here: https://linear.app/changelog/2025-05-01-mcp (https://mcp.linear.app/sse)

A [Model Context Protocol](https://github.com/modelcontextprotocol) server for the [Linear API](https://developers.linear.app/docs/graphql/working-with-the-graphql-api).

This server provides integration with Linear's issue tracking system through MCP, allowing LLMs to interact with Linear issues.

## Installation

### Automatic Installation

To install the Linear MCP server for Claude Desktop automatically via [Smithery](https://smithery.ai/protocol/linear-mcp-server):

```bash
npx @smithery/cli install linear-mcp-server --client claude
```

### Manual Installation

1. Create or get a Linear API key for your team: [https://linear.app/YOUR-TEAM/settings/api](https://linear.app/YOUR-TEAM/settings/api)

2. Add server config to Claude Desktop:
   - MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`

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

## Components

### Tools

1. **`linear_create_issue`**: Create a new Linear issues
   - Required inputs:
     - `title` (string): Issue title
     - `teamId` (string): Team ID to create issue in
   - Optional inputs:
     - `description` (string): Issue description (markdown supported)
     - `priority` (number, 0-4): Priority level (1=urgent, 4=low)
     - `status` (string): Initial status name

2. **`linear_update_issue`**: Update existing issues
   - Required inputs:
     - `id` (string): Issue ID to update
   - Optional inputs:
     - `title` (string): New title
     - `description` (string): New description
     - `priority` (number, 0-4): New priority
     - `status` (string): New status name

3. **`linear_search_issues`**: Search issues with flexible filtering
   - Optional inputs:
     - `query` (string): Text to search in title/description
     - `teamId` (string): Filter by team
     - `status` (string): Filter by status
     - `assigneeId` (string): Filter by assignee
     - `labels` (string[]): Filter by labels
     - `priority` (number): Filter by priority
     - `limit` (number, default: 10): Max results

4. **`linear_get_user_issues`**: Get issues assigned to a user
   - Optional inputs:
     - `userId` (string): User ID (omit for authenticated user)
     - `includeArchived` (boolean): Include archived issues
     - `limit` (number, default: 50): Max results

5. **`linear_add_comment`**: Add comments to issues
   - Required inputs:
     - `issueId` (string): Issue ID to comment on
     - `body` (string): Comment text (markdown supported)
   - Optional inputs:
     - `createAsUser` (string): Custom username
     - `displayIconUrl` (string): Custom avatar URL

### Resources

- `linear-issue:///{issueId}` - View individual issue details
- `linear-team:///{teamId}/issues` - View team issues
- `linear-user:///{userId}/assigned` - View user's assigned issues
- `linear-organization:` - View organization info
- `linear-viewer:` - View current user context

## Usage examples

Some example prompts you can use with Claude Desktop to interact with Linear:

1. "Show me all my high-**priority** issues" → execute the `search_issues` tool and/or `linear-user:///{userId}/assigned` to find issues assigned to you with priority 1

2. "Based on what I've told you about this bug already, make a bug report for the authentication system" → use `create_issue` to create a new high-priority issue with appropriate details and status tracking

3. "Find all in progress frontend tasks" → use `search_issues` to locate frontend-related issues with in progress task

4. "Give me a summary of recent updates on the issues for mobile app development" → use `search_issues` to identify the relevant issue(s), then `linear-issue:///{issueId}` fetch the issue details and show recent activity and comments

5. "What's the current workload for the mobile team?" → combine `linear-team:///{teamId}/issues` and `search_issues` to analyze issue distribution and priorities across the mobile team

## Development

1. Install dependencies:

```bash
npm install
```

1. Configure Linear API key in `.env`:

```bash
LINEAR_API_KEY=your_api_key_here
```

1. Build the server:

```bash
npm run build
```

For development with auto-rebuild:

```bash
npm run watch
```

## License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jerhadf](https://github.com/jerhadf)
- **Source:** [jerhadf/linear-mcp-server](https://github.com/jerhadf/linear-mcp-server)
- **License:** MIT
- **Homepage:** https://smithery.ai/server/linear-mcp-server

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-jerhadf-linear-mcp-server
- Seller: https://agentstack.voostack.com/s/jerhadf
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.