Can I create sub‑issues?

Yes. Use the `linear_create_issue` tool with the `makeSubissueOf` parameter set to the parent issue ID (e.g., `"TEAM-123"`).

Does the server support comment URLs?

Yes. The `thread` parameter in `linear_add_comment`, `linear_reply_to_comment`, and `linear_update_issue_comment` accepts full Linear comment URLs and automatically resolves them to UUIDs.

What credentials does it need?

It reads `LINEAR_API_KEY`, `DOWNLOAD_URL`, `TEST_LINEAR_API_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Linear MCP Server

linear MCP server based on mcp-go

Local serverstdioGo

What is the Linear MCP Server?

linear MCP server based on mcp-go

What it actually does

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.

Create, update, and search Linear issues
Get issues assigned to a user
Add comments to issues and reply to existing comments
URL-aware comment operations — - paste Linear comment URLs directly, no manual ID extraction needed
Retrieve team information
Rate-limited API requests to respect Linear's API limits

Configuration

Go 1.23 or higher - Linear API key

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
linear_create_issue	Creates a new Linear issue with specified details. Supports creating parent-child relationships (sub-issues) and assigning labels.
linear_update_issue
linear_search_issues
linear_get_user_issues	Retrieves issues assigned to a specific user or the authenticated user.
linear_get_issue
linear_add_comment	Adds a comment to an existing Linear issue. Supports replying to existing comments by passing a comment identifier in the thread parameter.
linear_reply_to_comment	Convenience tool for replying to an existing comment. Automatically resolves the issue from the comment, so you only need to provide the comment identifier and reply text.
linear_get_issue_comments	Retrieves comments for a Linear issue with support for pagination and thread navigation.
linear_update_issue_comment
linear_get_teams

Configuration

Go 1.23 or higher - Linear API key

Variable	Description	Required
LINEAR_API_KEY	Credential the server authenticates with.	Yes
DOWNLOAD_URL	Endpoint or connection string the server talks to.	Yes
TEST_LINEAR_API_KEY	Credential the server authenticates with.	Yes

Example prompts to try

“Use Linear to Automated.”
“Use Linear to linear create issue.”
“Use Linear to linear update issue.”

Frequently asked questions

Set `LINEAR_API_KEY` environment variable and execute `./linear-mcp-go serve`. By default the server runs in read‑only mode; use `--write-access` to enable create/update/comment tools.