How to Connect Linear and Sync Tasks

This guide walks you through connecting Linear to MONOid and syncing a team's issues and projects into a container. It takes about 5 minutes.

What you'll do

1. Connect your Linear account
2. Link a container to a Linear team
3. Let MONOid backfill and then stay in sync via webhooks
4. Verify tasks are syncing

1. Connect your Linear account

1. Open Settings from the gear icon at the bottom of the left sidebar.
2. Go to the Integrations tab (under Workspace for the workspace you want).
3. Find Linear and click Connect.
4. You'll be redirected to Linear's OAuth page — authorise MONOid to access your Linear workspace.
5. After authorising, you're redirected back to MONOid. The connection is now active.

MONOid requests the minimum permissions needed: read access to your teams, projects, and issues, plus webhook access to receive updates.

2. Link a container to a Linear team

After connecting, you'll see Link containers to Linear teams:

• Each row is a container in this workspace (personal or organisation).
• Use the dropdown to choose a Linear team for that container (or None to leave it unlinked).
• When you pick a team, MONOid links the container to that team and runs a one-time backfill: it fetches all past and active projects and issues from that team and creates MONOid projects and tasks in that container. No duplicate tasks — one task per Linear issue, and everyone in the org sees the same task.

You can link multiple containers to different teams, or leave some unlinked.

3. Organisation behaviour

If you're in an organisation workspace:

• All members can see the list of containers and which Linear team each is linked to.
• Only org admins can change the dropdown (link or unlink). Other members see the current link as read-only.

4. Verify the sync

Once a container is linked to a team:

1. Right after linking — The backfill creates MONOid projects and tasks from that team. You'll see a short “Syncing…” state, then a success message with counts.
2. New issues in Linear — Create a test issue in that team in Linear. Within a few seconds it should appear as a task in the linked container in MONOid.
3. Check the task's detail — it will have an external link (Linear icon) back to the issue. Moving the issue to "Done" in Linear will update the task status in MONOid.

You can find synced tasks in the container's task list, in My Inbox (if unscheduled), or on the Tasks page.

How sync works going forward

• Backfill once — Only when you link a container to a team. No separate “sync past issues” step.
• Webhooks — New and updated issues and projects in Linear are pushed to MONOid automatically. Unlink the container to stop syncing.
• Status — When an issue’s state changes in Linear (e.g. to Done), the linked task’s status updates in MONOid.
• One-way for creation — Tasks are created from Linear issues. You can still create tasks directly in MONOid that aren’t linked to Linear.

Troubleshooting

• Tasks aren't appearing? Confirm the container is linked to the correct team in Settings > Integrations. Check that the issue is in that team in Linear. Webhooks can be delayed during Linear outages.
• Wrong container? Change the dropdown to link the container to a different team, or set it to None and link another container to the team.
• Connection lost? Go to Settings > Integrations, disconnect Linear, and reconnect. This re-establishes the OAuth token and webhooks.

Next steps

• Linear — Full reference for the Linear integration
• Notion — Connect Notion for page and database sync
• How to Plan Your Week — Once tasks are flowing in, plan them into your week
• Integrations — Overview of all integration patterns