Linear integration
Create issues from messages, follow Linear updates in a channel, and let agents work with Linear.
Written By Katja Danilina
Last updated About 1 month ago
Connect Linear with an API key to create and link issues from any message, get Linear updates in a channel, give agents Linear tools, and start tasks when issues change.
Connect Linear
Go to Settings → Integrations and select Linear.
In Linear, open linear.app/settings/api, create a personal API key (it starts with lin_api_), and copy it.
Paste it into the API Key field in Mantle and select Connect.
One key unlocks message actions, channel updates, and agent tools. Triggers need an extra one-time authorization, described below.
Create or link an issue from a message
Open More actions (···) on any message:
Create Linear issue… opens a panel with the title and description filled in from the message. Choose the team, status, priority, assignee, project, and labels, then select Create Issue.
Link Linear issue… lets you search by title or identifier (for example NUL-123) and attach the issue to the conversation. Turn on Sync comments to get a notification when someone comments on it in Linear.
Add comment to issue… posts the message as a comment on the issue you choose.
Follow Linear in a channel
Open the channel's ··· menu (or right-click it in the sidebar) and choose Integrations. Pick a Linear team and, optionally, a project, then choose which events to post: issue created, status changed, and comment added are on by default; priority changed and issue assigned are optional.
Agent tools and triggers
Add Linear tools to an agent so it can read and update issues, projects, milestones, documents, comments, and more.
To start a task automatically, choose Integration → Linear in the task's trigger picker and pick events: issue created, status changed, priority changed, issue assigned, or comment added. The first time you save a Linear trigger, Mantle asks you to approve the event connection in Linear.
Troubleshooting
The key doesn't work: check that it starts with lin_api_. Create a fresh key in Linear and paste it again.
The Linear options don't appear in the message menu: they only show for people who have connected their own Linear key.
Trigger tasks don't run: make sure the task is active, the trigger is set to Linear with the right events, and re-authorize the event connection if Mantle says it expired.
Full guide: https://docs.mantle.chat/integrations/linear
Was this helpful?
More in Integrations
Connect an app (integrations overview)Build a bot for your organizationStill need help? Ask the team