Linear MCP
A Model Context Protocol (MCP) server for Linear, providing tools for issue tracking and project management.
Configuration
Go to Linear security settings and create an API key:
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)
| File | Size | Uploaded | |
|---|---|---|---|
| mcp_linear-0.1.1.tar.gz | 15.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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 logRelease 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