Stay on top of product development by searching, creating, and updating Linear issues directly from your Gumloop workflows. Quickly triage bugs, add new feature requests, or change priorities through automated workflows.

​
What is Linear MCP?

When you build a Linear node with AI, Gumloop creates a customized node that understands the Linear API. Simply describe what you need in plain English and the node selects the right endpoint, maps the fields, and returns clean structured data.

​
What Can It Do for You?

  • Find any issue in seconds using natural language search filters
  • Spin up new issues as soon as a bug report arrives in Slack or a form submission
  • Update status, assignee, or priority from anywhere in your workflow
  • Keep your team dashboards current by connecting Linear with Google Sheets or Slack

​
Available Tools

ToolWhat It DoesExample Use
Search IssuesSearch for issues in Linear using keywords, labels, states, assignees, or project IDs”Search issues with label bug in project Mobile App and return id, title, state, assignee, and url”
Create IssueCreate a new issue in any team or project”Create an issue in team Platform titled API rate limit error with description Users hit 429 after 60 requests and return id and url”
Update IssueUpdate an existing issue’s state, priority, assignee, or description”Update issue lin-1234 to state In Progress and assign to alice@company.com”

​
How to Use

1

Create Your Linear MCP Node

Go to your node library, search for Linear, and click “Create a node with AI”
2

Add Your Prompt

Drag the Linear node to your canvas and describe the single action you want it to perform, for example “search issues with label bug.”
3

Test Your Node

Run the node to verify the output. Adjust filters or fields as needed.
4

Save and Reuse

Save the node to your library so you can drop it into any future workflow.

​
Example Prompts

Here are some prompts that work well with Linear MCP: Search Issues: 
Search issues in team "Backend" where title contains "database timeout" and return id, title, state, assignee, and url
Create Issue: 
Create an issue in team "Growth" titled "Add referral tracking" with description "Implement UTM parameters for invites" and return id, number, and url
Update Issue: 
Update issue using an issue URL by setting priority to "High" and adding label "customer escalation"
Start with a simple action like “search issues with label Bug” before layering additional filters. This keeps the node fast and easy to debug.

​
Troubleshooting

If your Linear MCP node is not behaving as expected, try these best practices:

​
Keep Prompts Simple and Specific

  • Good: “Search issues labeled bug in project Checkout and return title and state”
  • Bad: “Search issues labeled bug, create a follow-up task if any are high priority”
While the bad example might seem convenient, it is more efficient to break it into separate nodes. Linear MCP works best with focused, single-action prompts.

​
Match What Linear Can Do

  • Good: “Given an Issue URL update the status to Done”
  • Bad: “Generate a PDF summary of all completed issues in the last 30 days”
Linear MCP excels at issue tracking. For document generation, combine it with an appropriate node like an Ask AI to generate the report.

​
Break Complex Tasks Into Steps

For best results, break complex requests into smaller steps. A prompt like: 
Search all open issues, update those over 7 days old to High priority, assign to the engineering manager, then send a summary to Slack
Might cause timeouts or unexpected results. Instead, create dedicated nodes:
1

Step 1: Search Old Issues

Search open issues older than 7 days and return id, title, and assignee
2

Step 2: Update Priority

Update issue issueId to priority “High”
3

Step 3: Format Summary

Use Ask AI to create a brief summary of the updated issues
4

Step 4: Send to Slack

Post the summary text to Slack channel “#eng-alerts” using a Slack Message Sender node
In your workflow, connect these nodes sequentially. The issue IDs from Step 1 feed into Step 2, the formatted summary from Step 3 flows into Step 4.

​
Focus on Data Retrieval

Linear MCP is great at getting information or updating a single issue. For analysis or content creation, pair it with other nodes. Example:
  • Good prompt: “Search issues assigned to bob@company.com and return id, title, and dueDate”
  • Bad prompt: “Search issues and draft a weekly report summarizing trends”
Use Linear MCP for the search, then pass the results to Ask AI to generate reports or insights.

​
Troubleshooting Node Creation

​
Need More Help?