← docsProject Management

/mcp-linear-sync

Bidirectional sync between local state and Linear.

Bidirectional sync between local workflow state and Linear project boards. Local changes propagate to Linear; Linear changes propagate locally. Conflict resolution via timestamp + manual override.

Category

Project Management

Execution

Bidirectional, timestamp-based

Goal

Keep local workflow state and Linear project boards in sync bidirectionally.

Scope

Applies to

  • +Teams tracking work both locally and in Linear
  • +CI workflows that update Linear

Does not cover

  • −One-way exports
  • −Non-Linear trackers

Triggers

"Sync with Linear""Push local state to Linear""Pull Linear changes"

Inputs

  • →Local workflow state file
  • →Linear project ID
  • →Last sync timestamp

Invariants

  • 01Must handle conflicts with timestamp comparison
  • 02Must log every sync operation
  • 03Must support manual override for conflicts

Procedure

  1. Step 1Read local workflow state
  2. Step 2Query Linear for changes since last sync
  3. Step 3Compare timestamps for conflicts
  4. Step 4Apply changes bidirectionally (or flag conflicts)
  5. Step 5Update last sync timestamp

Outputs

  • ▸Synced local state
  • ▸Synced Linear board
  • ▸Conflict log (if any)

Review Gate

  • [ ]No unresolved conflicts
  • [ ]Last sync timestamp updated
  • [ ]Sync log recorded