How to Use Linear MCP Server with Your AI

Linear is where modern software teams manage their work. It is fast, opinionated, and well-designed. But even a great tool adds overhead when you constantly switch to it for updates, issue creation, and status checks. The Linear MCP server lets your AI assistant interact with Linear directly, so project management happens inside your workflow rather than beside it.

Create issues, update statuses, check sprint progress, and triage incoming work, all through conversation with your AI.

What It Does

The Linear MCP server connects your AI to the Linear API. It can create and update issues with full details like assignees, labels, priorities, and estimates. It can search across your Linear workspace for specific issues or projects. It can read and update project and cycle statuses. It can list team members and their current assignments. And it can manage labels, milestones, and other workspace metadata.

Your AI becomes a project management assistant that knows your Linear workspace inside and out.

Prerequisites

• A Linear account with access to the workspace you want to manage.
• A Linear API key. Generate one from your Linear settings under API section.
• Node.js 18 or later installed on your machine.
• An MCP-compatible AI client such as Claude Desktop, Cursor, or Windsurf.

Step-by-Step Setup

1. Generate a Linear API Key

In Linear, go to Settings, then API, then "Personal API keys." Click "Create key," give it a descriptive label like "AI Assistant," and copy the generated key.

2. Add the Server Configuration

In your AI client's MCP configuration, add:

json{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-linear"],
      "env": {
        "LINEAR_API_KEY": "your_api_key_here"
      }
    }
  }
}

3. Restart Your AI Client

Save the configuration and restart. Your AI will now have access to your Linear workspace and its tools.

Things to Try

Here are scenarios where the Linear MCP server delivers immediate value:

• "Create a high-priority bug in the Frontend team's backlog titled 'Login page crashes on mobile Safari' with a description of the steps to reproduce." Full issue creation with all metadata in one request.

• "What issues are assigned to me that are due this week?" A quick personal dashboard without opening Linear.

• "Move all issues labeled 'v2.1' from 'Todo' to 'In Progress.'" Bulk status updates that would require clicking through each issue individually in the UI.

• "Give me a summary of our current sprint. How many issues are done, in progress, and blocked?" Sprint health checks in seconds.

• "Search for any issues related to the payment system that were created in the last 30 days." Cross-project search using natural language filters.

Tips and Tricks

Use it for daily standups. Before your standup meeting, ask your AI what you worked on yesterday, what is planned for today, and if anything is blocked. It pulls the information directly from Linear.

Triage faster. When new issues come in, ask your AI to show you the unassigned and untriaged issues. You can assign, prioritize, and label them through conversation.

Keep context in your editor. If you use Cursor or another AI-powered editor, the Linear MCP server lets you create and update issues without leaving your coding environment. Found a bug while coding? Create the issue right there.

Batch operations save time. Instead of creating issues one by one, describe a set of related tasks and let your AI create them all at once. "Create 5 issues for the API refactor: update auth endpoints, migrate user model, add rate limiting, update tests, update docs."

Tools That Pair Well

Linear works best as part of an integrated toolkit on a-gnt. The GitHub MCP server enables linking PRs to Linear issues for a complete development workflow. Use the Slack MCP server to post sprint updates and issue notifications to team channels. And the NNotion MCP server can help maintain project documentation that references Linear issues.

Find It on a-gnt

Explore the full listing for the Linear MCP server on a-gnt for detailed configuration options and community workflows.