Linear

You can connect Linear so that issues and projects from a Linear team sync into a MONOid container. Link each container to a Linear team; MONOid backfills once and then stays in sync via webhooks.

What you can sync from Linear

• Issues -> Tasks — Each Linear issue becomes one task in the linked container. Issue state changes (e.g. moved to "Done" in Linear) update the linked task's status.
• Projects -> Projects — Linear projects in that team become MONOid projects in the same container.
• One per container — One task per Linear issue and one project per Linear project per container. In organisations, all members see the same tasks and projects (no per-user copies).

Setup

1. Go to Settings > Workspace > Integrations and connect Linear (OAuth flow).
2. Under Link containers to Linear teams, pick a Linear team from the dropdown for each container (or None to unlink).
3. When you link a container to a team, MONOid runs a one-time backfill: it pulls in all past and active projects and issues from that team and creates linked projects and tasks. After that, webhooks keep everything in sync until you unlink.

You can link multiple containers to the same team or different teams. Unlink by choosing None for that container.

Organisations

• One set of settings — All members see the same container list and which containers are linked to which Linear teams.
• Only admins can edit — Only org admins can change the team dropdown or unlink. Other members see the current links as read-only.

Sync behaviour

• Trigger — Driven by Linear webhooks. New and updated issues and projects are processed as soon as Linear sends them.
• Status — Issue state changes in Linear update the linked task's status in MONOid. Linear is the source of truth for issue state.
• Assignee — When a Linear issue has an assignee and the workspace is an organisation, MONOid sets the task assignee to the matching org member when possible.

Labels in Linear don't automatically become MONOid tags; you can use them for filtering in Linear and plan the resulting tasks in MONOid.

Typical uses

• Linear backlog -> MONOid tasks — Link a container to a team; all issues (and projects) from that team sync in. Triage and schedule in My Inbox and Calendar; closing the issue in Linear updates the task.
• Multiple teams — Link different containers to different Linear teams so each container reflects one team's work.

Troubleshooting

• No task or project created — Confirm the container is linked to the correct Linear team in Settings > Integrations. Check that the event was a create (not only an update) if you're testing with existing data.
• Status not updating — Ensure the task was created from Linear (it has an external link). Status updates are applied automatically for linked tasks.
• Connection or webhook errors — Reconnect Linear in Settings > Integrations.

For more on how integrations work, see Integrations and API & Webhooks.