# GitScrum Tasks MCP > GitScrum Tasks connects your project management workflow directly to any AI agent. It lets you manage the entire task lifecycle—creating new items, adding subtasks and checklists, assigning ownership, setting story points, and tracking progress—all conversationally. Stop leaving your IDE or chat interface to update a Jira board; this MCP handles complex team coordination right where you are working. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** task-management, subtasks, checklists, task-assignment, kanban-workflow, story-points, task-comments ## Description You shouldn't have to switch apps just to move a task along the board. This connector lets your agent handle all of that manual clicking for you. You can ask it to create an entirely new bug or feature, assign it to a specific developer, and even set story points without opening a browser tab. Need to review progress? Your agent pulls up tasks based on filters like 'in-progress' or 'high effort,' showing exactly who owns what. It handles the messy details too: adding checklist items for investigation steps, logging detailed comments, or duplicating an existing task into a new project. With Vinkius in your catalog, you get one connection point to manage every aspect of your sprint backlog conversationally. You just talk to your agent, and it manages the whole flow. ## Tools ### assign_member Adds or removes a user from being responsible for a task. ### create_checklist_item Adds a new step to a checklist attached to an existing task. ### list_checklists Shows all the checklist items currently associated with a given task. ### toggle_checklist_item Marks a specific item on a checklist as completed or undone. ### create_comment Posts a detailed comment on a specific task, supporting rich text formatting. ### delete_comment Removes an existing comment from a task's history. ### list_comments Retrieves and displays the full history of comments on a specific task. ### update_comment Edits the text of an existing comment on a task. ### duplicate_task Creates an exact copy of an existing task for reuse elsewhere. ### list_effort_levels Shows all available effort or priority levels used in the project. ### set_task_estimate Sets a story point value or effort estimate for any given task. ### move_task_to_project Changes the main project that a task belongs to. ### my_tasks Gets a list of all tasks that are currently assigned directly to you. ### related_tasks Finds and lists tasks that have an established connection to the current task. ### link_subtask Attaches an existing task to another task as a required subtask item. ### list_subtasks Displays all subtasks linked to a main task. ### unlink_subtask Separates a subtask from its parent task. ### get_task_by_code Finds and retrieves a task using its human-readable code, like WEB-42. ### create_task Creates and initializes an entirely new task within the project. ### delete_task Permanently removes a task from the system. This action cannot be undone. ### toggle_task_done Changes the main completion status of an entire task (open to done). ### get_task Retrieves all details about a specific task using its unique identifier (UUID). ### list_tasks Fetches a list of tasks using advanced filters like status, sprint, or assignee. ### update_task Modifies general details and metadata for an existing task. ### my_today_tasks Retrieves a list of tasks due for completion today. ### create_task_type Defines a new category or type for tasks (e.g., Bug, Chore) with its own color code. ### list_task_types Lists every defined task type available within the project, along with their colors. ### unassign_member Removes a user from the list of people assigned to a task. ## Prompt Examples **Prompt:** ``` Show me all in-progress tasks in the web-app project. ``` **Response:** ``` Found 8 tasks in progress in web-app: 1) 'WEB-42: Implement auth flow' assigned to johndoe (Feature, High effort), 2) 'WEB-38: API rate limiting' assigned to janedoe (Improvement), 3) 'WEB-45: Dashboard redesign' unassigned... Would you like to assign the unassigned task or check subtasks for any of these? ``` **Prompt:** ``` Create a bug task 'Login timeout on slow connections' in web-app and assign it to janedoe. ``` **Response:** ``` Created task 'WEB-51: Login timeout on slow connections' as a Bug type in the web-app project, assigned to janedoe, placed in the 'To Do' column. The task code is WEB-51. Shall I add a checklist for the investigation steps or set a due date? ``` **Prompt:** ``` Add a checklist to task WEB-42 with items for 'Write unit tests', 'Update docs', and 'Deploy to staging'. ``` **Response:** ``` Done! Added 3 checklist items to WEB-42: ☐ Write unit tests, ☐ Update docs, ☐ Deploy to staging. All start as unchecked. Shall I mark any as complete or add sub-items under any of them? ``` ## Capabilities ### Find all current tasks You can query tasks using advanced filters for status, assignee, label, or date range. ### Manage task relationships The agent links existing tasks as subtasks and retrieves related items across the project. ### Track granular progress You can add checklist items, mark them done or undone, and toggle a main task's completion status. ### Collaborate on tasks The agent adds rich comments to a task or assigns/unassigns team members instantly. ### Organize the backlog You can create new tasks, update existing ones, duplicate them, and move them between projects. ## Use Cases ### The sprint review is running long and you need status updates. A PM asks their agent: 'Show me all tasks in the 'In Progress' column that are high effort.' The agent calls 'list_tasks' and presents a filtered list, letting the PM immediately identify bottlenecks without opening the board. ### You finished unit testing but need to log results and assign it. A developer tells their agent: 'Mark WEB-42 as done, add a comment saying I passed tests, and assign it to QA.' The agent executes 'toggle_task_done', then 'create_comment', and finally 'assign_member'—all in one chat sequence. ### A feature requires several investigation steps before coding can start. The Scrum Master asks the agent to add a checklist: 'Add a checklist for WEB-51 with items like 'Review API docs' and 'Get stakeholder sign-off.' The agent uses 'create_checklist_item,' turning vague goals into measurable next steps. ### You are duplicating a component across two different products. Instead of manually recreating the entire item, the developer asks the agent to duplicate WEB-105 and move it to the new project. The agent calls 'duplicate_task' followed by 'move_task_to_project', saving time. ## Benefits - You never have to context switch to the GitScrum UI again. Your agent handles every task update, assignment, and status change conversationally. - Review complex progress instantly. You can ask for a list of tasks filtered by multiple dimensions—status, effort level, or assignee—all in one query using 'list_tasks'. - Keep your history clean. Instead of manually updating comments, you just tell your agent to create or update the comment, maintaining rich context. - Manage dependencies effortlessly. If a task needs further work, use the agent to link an existing item as a subtask or retrieve all related tasks using 'related_tasks'. - Track effort and ownership precisely. Use 'set_task_estimate' to assign story points and 'assign_member' to ensure every piece of work has clear ownership. - Handle cleanup quickly. You can delete tasks permanently with 'delete_task', or remove users from a task using 'unassign_member'. ## How It Works The bottom line is that you never have to leave your chat interface to update project details again. 1. Subscribe to this MCP through Vinkius and enter your GitScrum API token and company slug. 2. Give your agent a natural language request, like 'Create a new tech debt task for the payments module.' 3. Your agent processes the request using available tools, creating or modifying the task status and reporting back what was done. ## Frequently Asked Questions **How do I list tasks using the GitScrum Tasks MCP?** You ask your agent to 'list_tasks' and provide filters like status, sprint, or assignee. It will return a filtered view of all relevant items. **Can I add comments with the GitScrum Tasks MCP?** Yes. You use the tool to create comments on any task, supporting rich text so you can include code blocks or formatting. **What is 'set_task_estimate' for in the GitScrum Tasks MCP?** This tool allows you to assign a story point value or effort estimate to any task, helping the team predict how long it will take. **Can I find a task without its UUID using the GitScrum Tasks MCP?** Absolutely. You use 'get_task_by_code' and just give your agent the human-readable code, like WEB-42, to fetch all details. **Does the GitScrum Tasks MCP handle subtasks?** Yes. You can use 'link_subtask' to attach existing tasks as dependencies and list them with 'list_subtasks'. **How do I modify details on an existing task using the `update_task` tool?** It lets you change almost any field on a task, like its description or due date. You must provide the unique task UUID and a payload detailing exactly what needs updating. **What happens when I use the `delete_task` tool?** The task is permanently removed from GitScrum; this action cannot be undone. Always verify the task ID before executing this command to prevent accidental data loss. **How do I pull a list of tasks assigned only to me with `my_tasks`?** This tool fetches every task currently assigned to your account immediately. It’s the fastest way to get an overview of your current workload without needing complex filtering. **Can my AI agent find a specific task by its human-readable code like WEB-42?** Yes! Use the `get_task_by_code` tool with the task code (e.g., WEB-42). Your agent will return the full task details including description, assignees, workflow status, labels, sprint association, time estimates, and checklist progress — in seconds. **I want to quickly see what I need to work on today. Can the agent help?** Absolutely. Use `my_today_tasks` to see everything due today, or `my_tasks` for your full assignment list across all workspaces. The agent returns task titles, project context, due dates, and current workflow status — your daily standup briefing in one command. **Can the agent manage task assignments and checklists too?** Yes. Use `assign_member` and `unassign_member` to manage task assignments by username. For checklists, use `create_checklist_item` to add items (including nested sub-items via parent_id), and `toggle_checklist_item` to mark them done. The complete task lifecycle is covered — from creation to completion.