# linear-mcp-go

> MCP Server

This Go-based repository provides a Model Context Protocol (MCP) server for Linear, enabling interaction with the Linear API for issue management, team information retrieval, and comment addition, while respecting API rate limits.

## Overview

- **Category:** Developer Tools
- **Language:** Go
- **Stars:** 11
- **Forks:** 0
- **Owner:** geropl
- **GitHub:** https://github.com/geropl/linear-mcp-go
- **Created:** 2025-02-27T15:35:29+00:00
- **Updated:** 2025-03-24T18:30:15+00:00
- **Source:** https://model-context-protocol.com/servers/go-linear-api-model-context-protocol

## Setup

## Setup

### From Releases

1.  Download the appropriate binary for your platform from the [GitHub Releases page](https://github.com/geropl/linear-mcp-go/releases).
2.  Make it executable (Linux/macOS):

```bash
chmod +x linear-mcp-go-*
```

3.  Run the binary as described in the Usage section

### Automated

```
# Download linux binary for the latest release
RELEASE=$(curl -s https://api.github.com/repos/geropl/linear-mcp-go/releases/latest)
DOWNLOAD_URL=$(echo $RELEASE | jq -r '.assets[] | select(.name | contains("linux")) | .browser_download_url')
curl -L -o ./linear-mcp-go $DOWNLOAD_URL
chmod +x ./linear-mcp-go

# Setup the mcp server (.gitpod.yml, dotfiles repo, etc.)
./linear-mcp-go setup --tool=cline
```

## Tools

## Available Tools

1.  Create, update, and search Linear issues (Allows interaction with Linear API through MCP protocol).
2.  Get issues assigned to a user (Retrieves issues for a specific user).
3.  Add comments to issues (Adds comments to existing Linear issues).
4.  Retrieve team information (Retrieves Linear teams with optional name filter).
5.  Rate-limited API requests (Respects Linear's API limits).
6.  `linear_create_issue` (Creates a new Linear issue with specified details).
7.  `linear_update_issue` (Updates an existing Linear issue's properties).
8.  `linear_search_issues` (Searches Linear issues using flexible criteria).
9.  `linear_get_user_issues` (Retrieves issues assigned to a specific user or the authenticated user).
10. `linear_get_issue` (Retrieves a single Linear issue by its ID).
11. `linear_add_comment` (Adds a comment to an existing Linear issue).
12. `linear_get_teams` (Retrieves Linear teams with an optional name filter).