Linear MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides tools for issue tracking and project management in Linear, allowing users to create and update issues, search and filter issues, retrieve user-assigned tasks, add comments, and access organizational information.

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

Resources

Linear MCP provides access to the following resource types:

ResourceDescriptionExample URI
IssueDetails of a specific Linear issuelinear-issue:///a1b2c3d4
Team IssuesAll issues for a specific teamlinear-team:///ENG/issues
User IssuesIssues assigned to a userlinear-user:///me/assigned
OrganizationDetails about your Linear organizationlinear-organization:
ViewerInformation about the authenticated userlinear-viewer:

Tools

ToolDescription
linear_create_issueCreate a new Linear issue with title, description, and other attributes
linear_update_issueUpdate an existing issue's properties
linear_search_issuesSearch issues using flexible filtering criteria
linear_get_user_issuesRetrieve issues assigned to a specific user
linear_add_commentAdd 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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

A Model Context Protocol server that integrates with Linear, enabling AI assistants to create, update, search, and comment on issues for project management and issue tracking.

  1. Configuration
    1. Running the Server
      1. Resources
        1. Tools
          1. Example Prompts
            1. Creating a New Issue
              1. Updating an Issue
                1. Searching for Issues
                  1. Retrieving User Tasks
                    1. Adding a Comment
                      1. Organization Overview
                      2. License