# Linear MCP for AI Agents AI Agent Connect > Linear MCP lets your AI agent manage your project boards, sprints, and issue tracking without you having to switch tabs. It handles everything from creating tickets and assigning priorities to checking cycle progress and querying team data. ## Overview - **Category:** loved-by-devs - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_7LRDSnlMqE2DKv929dsux3YlHvX1VtJoOC6wtB6T/ai-agent-connect - **Tags:** issue-tracking, agile, sprint-planning, workflow-automation, task-management, software-delivery ## Description Imagine you're in the middle of a deep coding session and realize you need to update a ticket's priority or assign a bug to someone else. Usually, that means breaking your flow to open a browser, find the right project, and click through several menus. This Connector changes that by letting your AI agent handle the heavy lifting. Instead of manual data entry, you just tell your agent what needs to happen. It can pull up a list of open issues for your team, tell you how much of the current sprint is left, or even draft a comment on a bug report while you stay focused on your IDE. It turns your AI into a sort of engineering manager that keeps the project moving in the background. You can find this and thousands of other connections in the Vinkius catalog to get your dev stack synced up quickly. It's about making the project management part of your job feel less like a chore and more like a conversation. Think about the time spent hunting for a specific ticket or trying to remember which team owns a particular bug. This Connector removes that friction. You can ask your agent to find every issue related to a specific feature or summarize the current status of a project. It handles the tedious parts of project management so you can spend more time actually shipping code. Whether you're updating a status, adding a mention to a teammate, or checking the completion percentage of a sprint, the AI does the clicking for you. It's about moving from a world of constant tab-switching to a world where your project management is just another part of your natural conversation with your agent. ## Tools ### list_linear_labels List issue labels ### list_linear_projects List active projects ### create_linear_comment Add a comment to an issue ### create_linear_issue Create a new issue ### get_linear_issue Get details for a specific issue ### list_linear_cycles List active cycles ### list_linear_issues List Linear issues ### list_linear_teams List workspace teams ### list_linear_users List workspace members ### check_linear_status Check API Status ### update_linear_issue Update an existing issue ## Prompt Examples **Prompt:** ``` What's the status of the mobile team's current sprint? ``` **Response:** ``` The Mobile team's active cycle is **#47** (Mar 31 — Apr 13) with **62%** completion. * **Total Issues:** 14 * **Completed:** 5 * **Remaining:** 9 Would you like me to list the remaining open issues for this cycle? ``` **Prompt:** ``` Create a high priority bug for the backend team called 'API Timeout'. ``` **Response:** ``` Done! I've created issue **BE-217** titled 'API Timeout' with **High** priority in the Backend team. You can view it here: [linear.app/yourco/issue/BE-217](https://linear.app/yourco/issue/BE-217) ``` **Prompt:** ``` Find all open issues for the engineering team. ``` **Response:** ``` I found 7 open issues for the Engineering team: | ID | Title | Priority | Assignee | |---|---|---|---| | ENG-142 | Fix auth token refresh bug | Urgent | @sarah_dev | | ENG-138 | Implement pagination | Normal | @mike_dev | | ENG-145 | Update README | Low | @dev_team | | ... | ... | ... | ... ``` ## Capabilities ### Create new tickets Generate new issues with specific priorities, labels, and descriptions instantly. ### Query existing issues Search through your backlog using keywords or filter by specific teams. ### Update ticket details Modify assignees, priorities, and statuses of existing tickets via chat. ### Check sprint progress Retrieve the completion percentage and dates for any team's active cycle. ### Add comments Post updates to issues using Markdown and @mentions without leaving your workspace. ### Browse projects View high-level project details and team structures across your entire workspace. ## Use Cases ### Log a bug while coding A developer wants to log a bug while coding. They ask the agent to create an issue with high priority for the backend team. ### Check sprint status A manager needs a status update. They ask the agent to list the current cycle progress for the mobile team. ### Search for blockers A product lead is looking for blockers. They ask the agent to search for all unresolved issues in the engineering team. ### Update ticket details A team member needs to update a ticket. They ask the agent to change the assignee and status of a specific issue. ## Benefits - Stop tab switching: Use `list_issues` and `search_issues` to see what's on your plate without leaving your editor. - Faster ticket creation: Use `create_issue` to log bugs or tasks instantly as they come to mind. - Better team context: Use `create_comment` to keep discussions updated with mentions while you stay in your flow. - Real-time sprint tracking: Use `list_cycles` to see exactly how much of the current sprint is finished. - Organized project oversight: Use `list_projects` and `get_project` to get a bird's eye view of your roadmap. - Easier team discovery: Use `list_teams` and `list_labels` to quickly find the right categories for your work. ## How It Works The bottom line is you get to manage your entire engineering workflow through a chat interface instead of a cluttered dashboard. 1. Subscribe to this Connector in the Vinkius catalog. 2. Enter your Linear Personal API Key in the configuration settings. 3. Start asking your agent to manage your tickets or check sprint status. ## Frequently Asked Questions **Can I use the Linear MCP to create tickets?** Yes, you can create new issues with a title, description, priority level, and specific labels directly through your AI client. **Does Linear MCP support sprint cycles?** Yes, it can list all cycles for your teams, including start and end dates as well as the current completion percentage. **Can my AI agent add comments to Linear?** Yes, your agent can post comments on issues using Markdown and @mentions to keep your team updated. **How do I find my team ID for the Linear MCP?** You can use the list_teams tool to see all teams in your workspace, which will provide the unique IDs needed for specific queries. **Can I update existing issues using this Connector?** Yes, you can update any field on an existing ticket, such as the status, assignee, or priority, using its unique identifier. **Is there a way to search for issues with specific keywords?** Yes, the search_issues tool allows you to find tickets by typing in keywords or filtering by a specific team. **How do I find my Linear Personal API Key?** Go to [**Linear Settings > API**](https://linear.app/settings/api) and click **Create API Key**. Give it a descriptive name like 'Vinkius MCP' and copy the generated key immediately — it won't be shown again. **Can I create new issues with assignees and labels?** Yes! Use the `create_issue` tool with the required `team_id` and `title` parameters. Optionally provide `assignee_id`, `priority` (0-4), `description` in Markdown and `label_ids` as a comma-separated list. The agent will return the created issue's identifier and URL. **Does the agent have access to delete issues or modify team settings?** No. This server focuses on read operations and safe mutations — creating issues, updating fields and adding comments. Destructive actions like deletion or team configuration changes are not exposed, keeping your workspace secure. **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.