# Linear MCP for AI Agents AI Agent Connect

> Linear MCP connects your project management workspace to your AI agent. It lets your agent read issues, update statuses, and manage cycles so you don't have to jump back and forth between your code editor and your project board.

## Overview
- **Category:** loved-by-devs
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_c0tDYaRGjPmg7cuYAqlyaFqCyZ3eXp7hRHw1peWy/ai-agent-connect
- **Tags:** issue-tracking, agile, sprint-planning, workflow-automation, task-management, software-delivery

## Description

This Linear MCP lets your agent act as a project coordinator. Instead of copy-pasting status updates or manually creating tickets, you can just tell your agent what's happening in your sprint. It pulls in real-time data on active issues, project milestones, and team assignments so your agent always has the full picture. You find it easier to keep your backlog organized because your agent can handle the busy work of updating labels or adding comments to specific tickets while you stay focused on shipping. It's one of the many ways Vinkius makes your development workflow tighter by bridging the gap between your project management tools and your daily dev environment. You can check your team's capacity, monitor cycle progress, and keep everyone aligned without ever leaving your terminal or IDE. This means you don't have to worry about missing a deadline or forgetting to update a high-priority bug. Your agent handles the repetitive data entry of agile project management, whether that means moving a ticket from 'Backlog' to 'In Progress' or tagging a new feature with the correct label. It turns your project board into an active participant in your development process, rather than just a place where you go to record what you already did. You can ask for a summary of what's pending, request that a new task be added to the current cycle, or get a quick pulse check on team velocity. By integrating this Connector, you turn a manual tracking process into a conversational workflow that keeps your team moving.

## Tools

### list_linear_issues
List Linear issues in your workspace. This helps your agent see what's on the plate.

### list_linear_labels
List issue labels for your project. This helps with organizing work.

### list_linear_projects
List active projects. This keeps your agent aware of the big picture.

### list_linear_teams
List workspace teams. Use this to understand your org structure.

### list_linear_users
List workspace members. This is great for checking who's on the team.

### check_linear_status
Check the API status. Use this to verify your setup works.

### update_linear_issue
Update an existing issue. This makes updating statuses a breeze.

### create_linear_comment
Add a comment to an issue. Use this to keep the conversation in one place.

### create_linear_issue
Create a new issue for your team. This lets your agent handle ticket creation.

### get_linear_issue
Get details for a specific issue. This gives your agent the context it needs.

### list_linear_cycles
List active cycles. Use this to track sprint progress.

## Prompt Examples

**Prompt:** 
```
What's on my plate today?
```

**Response:** 
```
### Today's Tasks
Based on your active cycles, here is what's pending:

| Issue | Status | Priority |
| :--- | :--- | :--- |
| **Fix Header Alignment** | In Progress | High |
| **Update Auth Flow** | To Do | Medium |
| **Refactor API Layer** | Blocked | High |

Would you like me to pull the full details for the **Auth Flow** ticket?
```

**Prompt:** 
```
Create a bug ticket for the broken header.
```

**Response:** 
```
I've created that for you! 

**New Issue Created:**
- **Title:** Fix broken header alignment
- **ID:** FRONT-124
- **Team:** Frontend
- **Status:** Backlog

I've also added a comment noting that this was reported during the morning smoke test.
```

**Prompt:** 
```
Who's on the mobile team?
```

**Response:** 
```
The **Mobile** team currently has 6 members assigned:

- **Alex Rivera** (Lead)
- **Jordan Smith** (Engineer)
- **Casey Chen** (Engineer)
- **Taylor Reed** (Designer)
- **Morgan Lee** (QA)
- **Riley Quinn** (Engineer)

Would you like to see their current task load?
```

## Capabilities

### Create new issues
Generate a new ticket for a bug or feature using natural language commands.

### Update ticket statuses
Change a task from 'In Progress' to 'Done' instantly through your AI client.

### List active projects
See what your team is currently working on across your entire workspace.

### Add comments to issues
Leave feedback or updates on specific tickets without switching browser tabs.

### Monitor team members
Identify who is assigned to what and see who is available for new tasks.

## Use Cases

### Updating a ticket after a push
An engineer finishes a bug fix and asks their agent to move the ticket to 'Done' using update_linear_issue.

### Quickly creating a new feature task
A product manager notices a new requirement and asks their agent to create a ticket for the frontend team using create_linear_issue.

### Checking project status during a meeting
A lead asks their agent to list active projects and get details on a specific issue to see if it's blocked.

### Syncing team assignments
A manager asks the agent to see who is currently assigned to the mobile team using list_linear_users and list_linear_teams.

## Benefits

- Stop context switching by updating ticket statuses using update_linear_issue directly from your AI client.
- Keep your backlog organized by having your agent create new tickets with create_linear_issue as you discover bugs.
- Get a bird's eye view of your roadmap by using list_linear_projects to see what's coming next.
- Maintain clear communication by adding feedback to tickets with create_linear_comment without opening your browser.
- Improve team visibility by checking who's available and assigned using list_linear_users and list_linear_teams.

## How It Works

The bottom line is that your AI agent handles the administrative overhead of project management so you can focus on writing code.

1. Subscribe to this Connector on the Vinkius Marketplace.
2. Grab your Personal API Key from your Linear account settings.
3. Connect the Connector to your AI client to start managing tickets with voice or text.

## Frequently Asked Questions

**Can the Linear MCP update my tickets automatically?**
Yes. Your agent can change ticket statuses, update labels, and modify issue details instantly based on your instructions.

**How do I use the Linear MCP to manage my sprints?**
You can ask your agent to list active cycles, check project progress, or move tickets between different stages of your sprint.

**Can my AI agent create new issues for my team?**
Yes. You can describe a bug or feature in plain English, and your agent will create the ticket, assign it to the right team, and apply labels.

**Does the Linear MCP help with team capacity?**
It does. Your agent can list team members and their current assignments, helping you see who is available for new work.

**How do I connect Linear to my AI client?**
Just subscribe to this Connector on Vinkius, grab your Personal API Key from your Linear settings, and connect it to your preferred AI client.

**Can the Linear MCP read my project cycles?**
Yes. Your agent can access your active cycles to help you monitor sprint progress and keep your development goals on track.

**How do I find my Linear Personal API Key?**
Log in to your account, navigate to **Settings** > **API**, and generate a new high-fidelity **Personal API Key**.

**Can I check project progress via AI?**
Yes! The `get_linear_project` tool allows your agent to retrieve high-fidelity progress metrics and health data for any specific project.

**How do I list my active cycles?**
Use the `list_linear_cycles` tool to retrieve the complete high-fidelity directory of cycles along with their technical status and progress metrics.