Linear Sync MCP

Connect Claude and AI coding agents to Linear issue tracking with automatic code sync, status updates, and multi-agent workflow orchestration.

Installation

Quick Start

npx linear-sync-mcp

Global Installation

npm install -g linear-sync-mcp

Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "linear-sync-mcp": {
      "command": "npx",
      "args": ["-y", "linear-sync-mcp"]
    }
  }
}

Cursor

Add to your MCP settings:

{
  "mcpServers": {
    "linear-sync-mcp": {
      "command": "npx",
      "args": ["-y", "linear-sync-mcp"]
    }
  }
}

Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "linear-sync-mcp": {
      "command": "npx",
      "args": ["-y", "linear-sync-mcp"]
    }
  }
}

Setup

1. Get your Linear API key from linear.app/settings/api
2. Set environment variable:

   export LINEAR_API_KEY=your_api_key_here

Tools

get_issue

Fetch a specific Linear issue by ID or key.

get_issue(issueId: "LIN-123")

search_issues

Search issues across your Linear workspace with filters.

search_issues(query: "bug", status: "In Progress", limit: 10)

create_issue

Create a new Linear issue with title, description, and metadata.

create_issue(title: "Fix login bug", description: "Users cannot login with SSO", teamId: "team-123")

update_issue_status

Update an issue's status (e.g., "Todo", "In Progress", "Done").

update_issue_status(issueId: "LIN-123", status: "In Progress")

link_branch_to_issue

Link a git branch to a Linear issue for automatic tracking.

link_branch_to_issue(issueId: "LIN-123", branchName: "fix/login-bug")

post_issue_comment

Add a comment to an issue with code snippets or updates.

post_issue_comment(issueId: "LIN-123", comment: "Fixed in PR #456")

list_team_issues

List all issues for a specific team with filtering options.

list_team_issues(teamId: "team-123", status: "In Progress")

Features

• 🔄 Auto-sync code changes to Linear issues
• 📊 Automatic status updates based on PR activity
• 💬 Create linked issues from code comments
• 🤖 Multi-agent workflows across Linear projects
• 🔗 Branch-to-issue linking for seamless tracking

License

Open source and free to use.

Built with AI by Craftpipe

Support: [email protected]

⭐ Pro Features

Upgrade to Pro for additional tools:

• batch operations
• automation

Get Pro → craftpipe.gumroad.com (€29/mo)

Set PRO_LICENSE=<your-key> environment variable to unlock premium tools.