Linear
Linear connects issue work to Mobius.
A Linear integration connects a Linear workspace to Mobius so assistants can create and update issues, search workspace metadata, and respond to Linear events.
Use Linear when Mobius should triage issues, open follow-up work, comment on existing issues, or route updates by team, project, cycle, label, or state.
Capability map
| Capability | Value |
|---|---|
| Provider ID | linear |
| Auth kind | oauth2_user |
| Connect flow | Linear OAuth, with a legacy API-key fallback when OAuth is unavailable |
| Actions | Yes |
| Events | Yes |
| Webhook delivery | Yes |
| Event samples | Yes |
| Live status | No |
Connect Linear
| Surface | Support |
|---|---|
| App | Open Build > Integrations, choose Linear, select Continue with Linear, and choose the workspace to authorize. |
| CLI | The mobius CLI does not connect Linear integrations yet. Use the app or API. |
| API | Call POST /v1/integrations/providers/linear/connect with {}, then send the browser to the returned redirect_url. |
Mobius acts as the installed app in the selected workspace. A deployment that does not have Linear OAuth configured can still expose the older API-key connect flow.
Linear is a team-managed workspace connection, so an organization administrator connects or reconnects it. Under Assistant access, grant the exact workspace to the assistants that need it and choose the team or named people as its Mobius result audience. The same grant covers conversations and routines, while each routine saves the exact Linear connection it uses.
Mobius validates the completed connection before marking it ready. If a Linear event does not arrive, check recent provider events first.
Actions
linear.cycle.list
linear.issue.add_comment
linear.issue.create
linear.issue.get
linear.issue.search
linear.issue.update
linear.issue_label.search
linear.project.search
linear.team.list
linear.user.search
linear.workflow_state.listUse reference pickers or search actions for team, project, user, label, cycle, and state IDs. They stay stable when Linear display names change.
linear.issue.create, linear.issue.add_comment, and linear.issue.update
change the workspace without an automatic Mobius confirmation. The exact
Linear connection and assistant grant are still rechecked before dispatch.
Events
linear.comment.created
linear.comment.removed
linear.comment.updated
linear.cycle.created
linear.cycle.removed
linear.cycle.updated
linear.issue.created
linear.issue.removed
linear.issue.updated
linear.issue_label.created
linear.issue_label.removed
linear.issue_label.updated
linear.project.created
linear.project.removed
linear.project.updated
linear.reaction.created
linear.reaction.removed
linear.reaction.updatedUse linear.issue.created for intake and linear.issue.updated for state or
assignee changes. Prefer narrow event names over wildcards so unrelated updates
do not add noise.
Next
- Review account access in Connect accounts.
- Grant Linear actions to an assistant from actions.
- Debug provider delivery with source events.