Skip to main content

Linear MCP

A Model Context Protocol (MCP) server for Linear, providing tools for issue tracking and project management.

Linear Server MCP server

Configuration

Go to Linear security settings and create an API key:

linear-security-settings

Then, configure it with the LINEAR_API_KEY env variable:

# Add to your .env file
LINEAR_API_KEY=lin_api_xxxxxxxxxxxx

# Or export as environment variable
export LINEAR_API_KEY=lin_api_xxxxxxxxxxxx

Running the Server

uvx --from git+https://github.com/vinayak-mehta/linear-mcp linear-mcp

Docker

docker build -t linear-mcp:latest .
docker run -it --rm -e LINEAR_API=lin_api_xxxxxx linear-mcp:latest

And to use this in Claude Desktop, it would look like this:

    "linear-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-it",
        "--rm",
        "-e",
        "LINEAR_API_KEY=lin_api_xxxxxx",
        "linear-mcp-server:latest"
      ]
    }

Resources

Linear MCP provides access to the following resource types:

Resource Description Example URI
Issue Details of a specific Linear issue linear-issue:///a1b2c3d4
Team Issues All issues for a specific team linear-team:///ENG/issues
User Issues Issues assigned to a user linear-user:///me/assigned
Organization Details about your Linear organization linear-organization:
Viewer Information about the authenticated user linear-viewer:

Tools

Tool Description
linear_create_issue Create a new Linear issue with title, description, and other attributes
linear_update_issue Update an existing issue's properties
linear_search_issues Search issues using flexible filtering criteria
linear_get_user_issues Retrieve issues assigned to a specific user
linear_add_comment Add a comment to an existing issue

Example Prompts

Creating a New Issue

Create a bug ticket: "Login screen disappears like magic tricks at a birthday party!" Priority: HIGH, Team: Engineering

Updating an Issue

Upgrade ENG-123 to "shooting star" priority! Users are excited! Change status to "Racing to the finish line!"

Searching for Issues

Find all Frontend tasks with "authentication" that are patiently waiting for their moment to shine

Retrieving User Tasks

What exciting challenges await me today in Linear?

Adding a Comment

Add to DEV-456: "Temporarily paused while the API does its beauty routine. Back on it next sprint with fresh energy!"

Organization Overview

Show me our amazing team structure so I can appreciate all the talented people making this happen

License

Apache 2.0

Metadata

Release files for mcp-linear 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-linear 0.1.1
File Size Uploaded
mcp_linear-0.1.1.tar.gz 15.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-linear 0.1.1
File Interpreter ABI Platform
mcp_linear-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 30.1 kB

Release files / mcp_linear-0.1.1.tar.gz

Download URL mcp_linear-0.1.1.tar.gz
Size 15.1 kB
Tags Source
SHA-256 checksum
How to use checksums
8d54f65a526473aaed62f6a6c22f4abcb5a81d256b06a234422ce29dfa81af2b
BLAKE2b-256 checksum
How to use checksums
3dfac8a42040562fef83ba561ca7f4c5126f697a02219915355c377c289060d9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 30, 2025.

Transparency log

Release files / mcp_linear-0.1.1-py3-none-any.whl

Download URL mcp_linear-0.1.1-py3-none-any.whl
Size 15.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0f8d8b9ce697b728b2c1f4e27daf9dbdf93fdd4ff3bdf3682bb14a61048d19dc
BLAKE2b-256 checksum
How to use checksums
51e496bd8ea4533b7eba18fba32f09ec9e12902a5ecef6a5a2d85a7e8b76da8a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Mar 30, 2025.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page