Skip to main content
Linear is a modern issue tracking platform for product teams. The Linear MCP server lets you search, create, and update issues using natural language.

​
What Can It Do?

  • Search issues using keywords, labels, states, or assignees
  • Create new issues in any team or project
  • Update issue status, priority, or assignee
  • Triage bugs and feature requests automatically

​
Where to Use It

Add Linear as a tool to any agent. The agent can then manage your issues conversationally, choosing the right actions based on context. To add an MCP tool to your agent:
  1. Open your agent’s configuration
  2. Click Add tools → Connect an app with MCP
  3. Search for the integration and select it
  4. Authenticate with your account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.

​
In Workflows (Via Agent Node)

For automated pipelines, use an Agent Node with Linear tools. This gives you the flexibility of an agent within a deterministic workflow.

​
As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
  1. Go to your node library and search for the integration
  2. Click Create a node with AI
  3. Describe the specific action you want (e.g., “Create a bug in team Platform”)
  4. Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.

​
Available Tools

ToolDescription
Search IssuesSearch issues with filters
Create IssueCreate a new issue in any team
Update IssueUpdate status, priority, or assignee

​
Example Prompts

Use these with your agent or in the Agent Node: Find issues: 
Search for bugs labeled "critical" in the Backend team
Create an issue: 
Create an issue in team Growth titled "Add referral tracking"
Update status: 
Move the API rate limit issue to In Progress
Assign work: 
Assign the database timeout issue to [email protected]
Check status: 
What's the status of the checkout bug?

​
Troubleshooting

IssueSolution
Agent not finding the right dataUse specific issue titles or team names
Action not completingCheck that you’ve authenticated with Linear
Unexpected resultsThe agent may chain multiple tools (e.g., searching first, then updating). Review the agent’s reasoning to understand its approach.
Tool not availableVerify the tool is enabled in your agent’s MCP configuration
Agents are smart enough to chain multiple API calls together. For example, asking “Set the checkout bug to high priority” will find the issue first, then update it. If results seem off, check the agent’s step-by-step reasoning.

​
Need Help?

Use this integration directly in Claude or Cursor. Connect remotely via the Linear MCP server using your Gumloop credentials.