consigcody94/linear-flow

📋 Linear Flow

AI-powered Linear project management - create issues, manage projects, track cycles, and automate your workflow

🤔 The Project Management Challenge

"Context switching to Linear breaks my flow"

Every time you need to create an issue, update a status, or check sprint progress, you're switching contexts and losing momentum.

• 🖱️ Clicking through UI forms
• 🔍 Searching for team and state IDs
• 📊 Checking cycle progress manually
• 🏷️ Managing labels across projects

Linear Flow keeps you in the zone - manage your entire Linear workflow through natural language without leaving your editor.

✨ Features

🚀 Quick Start

Prerequisites

• Node.js 18+
• Linear account with API key
• Claude Desktop

Installation

git clone https://github.com/consigcody94/linear-flow.git
cd linear-flow
npm install
npm run build

Get Your API Key

1. Go to Linear Settings
2. Click "Create key" under "Personal API keys"
3. Give it a label (e.g., "MCP Server")
4. Copy the generated key (starts with lin_api_)

Configure Claude Desktop

Add to your config file:

{
  "mcpServers": {
    "linear-flow": {
      "command": "node",
      "args": ["/absolute/path/to/linear-flow/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "lin_api_your_key_here"
      }
    }
  }
}

Restart Claude Desktop

Completely quit and reopen Claude Desktop to load the MCP server.

💬 Usage Examples

Create Issues

"Create a high-priority bug for the authentication team"
→ Creates issue with priority 2 (High) assigned to ENG team

"Add a feature request for implementing OAuth2 with detailed requirements"
→ Creates issue with markdown description and proper labeling

Track Progress

"What's in the current sprint?"
→ Returns cycle info with issue count, completion %, and dates

"Show me the ENG team's workflow states"
→ Lists all states with IDs for transitions

Manage Workflow

"Move FEAT-123 to In Progress"
→ Updates issue state to in_progress

"Create a new project for Q1 platform improvements"
→ Creates project linked to specified teams

Organize with Labels

"Create a tech-debt label with red color for the ENG team"
→ Creates label with hex color #FF6B6B

"Add the urgent label to the login bug"
→ Updates issue with new label

🛠️ Available Tools

📊 Tool Details

create_issue

Create a new issue in Linear.

update_issue

Update an existing issue.

get_team

Get team information including workflow states.

Response includes:

• Team ID, key, and name
• Workflow states with IDs, names, types, and colors

get_cycle

Get cycle (sprint) information.

Response includes:

• Cycle ID and number
• Start and end dates
• Issue count and completed count
• Progress percentage

create_project

Create a new project.

add_label

Create a new label for a team.

🔑 Finding IDs

🎯 Workflow Examples

Bug Triage Workflow

1. Create the bug:

   create_issue with title: "Login fails on Safari", teamId: "ENG", priority: 2
   

2. Get team states:

   get_team with teamId: "ENG"
   

3. Update to triage state:

   update_issue with issueId: "...", stateId: "state_triage"
   

Sprint Planning

1. Check current cycle:

   get_cycle with teamId: "ENG"
   

2. Create sprint issues:

   create_issue with title: "...", teamId: "ENG", ...
   

3. Create organizing project:

   create_project with name: "Sprint 5 Goals", teamIds: ["ENG"]
   

🔒 Security Notes

🐛 Troubleshooting

📋 Requirements

• Node.js 18 or higher
• Linear API key
• Active Linear workspace

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT License - see file for details.

👤 Author

consigcody94

Stay in flow while managing your workflow.