A Model Context Protocol (MCP) server for Linear, written in Go. This server provides tools for interacting with the Linear API through the MCP protocol.
Features
Create, update, and search Linear issues
Get issues assigned to a user
Add comments to issues
Retrieve team information
linear MCP server based on mcp-go
—
Rate-limited API requests to respect Linear's API limits
Prerequisites
Go 1.23 or higher
Linear API key
Installation
From Releases
Pre-built binaries are available for Linux, macOS, and Windows on the GitHub Releases page.
Download the appropriate binary for your platform
Make it executable (Linux/macOS):
chmod +x linear-mcp-go-*
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
Usage
Running the Server
Set your Linear API key as an environment variable:
export LINEAR_API_KEY=your_linear_api_key
Run the server:
# Run in read-only mode (default)
./linear-mcp-go serve
# Run with write access enabled
./linear-mcp-go serve --write-access
The server will start and listen for MCP requests on stdin/stdout.
Setting Up for AI Assistants
The setup command automates the installation and configuration process for various AI assistants:
# Set your Linear API key as an environment variable
export LINEAR_API_KEY=your_linear_api_key
# Set up for Cline (default)
./linear-mcp-go setup
# Set up with write access enabled
./linear-mcp-go setup --write-access
# Set up with auto-approval for read-only tools
./linear-mcp-go setup --auto-approve=allow-read-only
# Set up with specific tools auto-approved
./linear-mcp-go setup --auto-approve=linear_get_issue,linear_search_issues
# Set up with write access and auto-approval for read-only tools
./linear-mcp-go setup --write-access --auto-approve=allow-read-only
# Set up for a different tool (only "cline" supported for now)
./linear-mcp-go setup --tool=cline
This command:
Checks if the Linear MCP binary is already installed
Copies the current binary to the installation directory if needed
Configures the AI assistant to use the Linear MCP server
Sets up auto-approval for specified tools if requested
The --auto-approve flag can be used to specify which tools should be auto-approved in the Cline configuration:
--auto-approve=allow-read-only: Auto-approves all read-only tools (linear_search_issues, linear_get_user_issues, linear_get_issue, linear_get_teams)
--auto-approve=tool1,tool2,...: Auto-approves the specified comma-separated list of tools
Currently supported AI assistants:
Cline (VSCode extension)
By default, the server runs in read-only mode, which means the following tools are disabled:
linear_create_issue
linear_update_issue
linear_add_comment
To enable these tools, use the --write-access=true flag.
Available Tools
linear_create_issue
Creates a new Linear issue with specified details. Supports creating sub-issues and assigning labels.
Parameters:
title (required): Issue title
team (required): Team identifier (key, UUID or name)
description: Issue description
priority: Priority (0-4)
status: Issue status
parentIssue: Optional parent issue ID to create a sub-issue
labels: Optional comma-separated list of label IDs to assign
linear_update_issue
Updates an existing Linear issue's properties.
Parameters:
id (required): Issue ID
title: New title
description: New description
priority: New priority (0-4)
status: New status
linear_search_issues
Searches Linear issues using flexible criteria.
Parameters:
query: Optional text to search in title and description
teamId: Filter by team ID
status: Filter by status name (e.g., 'In Progress', 'Done')
assigneeId: Filter by assignee's user ID
labels: Filter by label names (comma-separated)
priority: Filter by priority (1=urgent, 2=high, 3=normal, 4=low)
estimate: Filter by estimate points
includeArchived: Include archived issues in results (default: false)
limit: Max results to return (default: 10)
linear_get_user_issues
Retrieves issues assigned to a specific user or the authenticated user.
Parameters:
userId: Optional user ID. If not provided, returns authenticated user's issues
includeArchived: Include archived issues in results
limit: Maximum number of issues to return (default: 50)
linear_get_issue
Retrieves a single Linear issue by its ID.
Parameters:
issueId (required): ID of the issue to retrieve
linear_add_comment
Adds a comment to an existing Linear issue.
Parameters:
issueId (required): ID of the issue to comment on
body (required): Comment text in markdown format
createAsUser: Optional custom username to show for the comment
displayIconUrl: Optional avatar URL for the comment
linear_get_teams
Retrieves Linear teams with an optional name filter.
Parameters:
name: Optional team name filter. Returns teams whose names contain this string.
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo Linear MCP Go?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Linear MCP Go precisa de uma chave de API?
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Linear MCP Go usa?
Linear MCP Go roda localmente via stdio.
Quando Linear MCP Go foi verificado pela última vez?
Última verificação: 2026-10-28. linear MCP server based on mcp-go