Skip to main content
Integrations

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

  1. Go to Settings → Integrations and select Linear.

  2. In Linear, open linear.app/settings/api, create a personal API key (it starts with lin_api_), and copy it.

  3. 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