# TeamGantt MCP > TeamGantt gives you conversational control over complex project timelines. It connects your AI client directly to your Gantt data so you can manage tasks, assign resources, and track dependencies without touching a dashboard. You tell the agent what needs changing—like 'Mark Task X as 100% done' or 'List all resources needed for Q4'—and it updates the timeline instantly. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** gantt-charts, project-planning, task-management, resource-allocation, timeline-tracking, team-collaboration ## Description Listen, forget logging into a massive dashboard just to change a date or check who's available. This server hooks your AI client right up to TeamGantt data, letting you run complex project management commands purely through natural conversation. You don't touch the graphical interface; you just tell your agent what needs fixing, and it updates the entire timeline instantly. **Getting a Read on Your Workload** You can start broad or get surgical with the metadata. Need to know everything going on? Use `list_projects` to pull a master list of every project in your account. If you zero in on one job, `get_project_details` fetches all the deep configuration and details for that specific Gantt chart. From there, you can get an overview using `list_project_tasks`, which gives you a full rundown of every single task currently tracked in that timeline. **Deep Task Dive and Management** When you need specifics, you've got options. If you want the status and date range for one particular item, run `get_task_info`. But if you need to see what smaller steps make up a big parent task, use `get_task_checklist` to list all those sub-tasks associated with it. You can manage the core tasks themselves—you'll never have to manually update a percentage again because you've got `update_task_fields`, which lets you change a task’s status, adjust its completion percentage, or shift its dates directly via chat. If something is finished and needs to go, use `remove_task` to delete it from the timeline. And if you gotta put something new on the board? Just kick off `create_new_task`, and it'll show up right where it belongs. **Connecting Tasks and Goals** Project logic is what keeps things running smoothly, and that’s where dependencies come in. You can use `link_tasks_dependency` to enforce a strict sequence between two tasks—say, Task A has to finish before Task B even starts. This keeps your project timeline sound automatically. For high-level goals, you'll pull the major markers using `list_project_milestones`. If you want to review the smaller components needed to hit that milestone, you can check the associated sub-task checklists. **Staffing and Resources** Knowing who's doing what is key. You can get a full picture of your team or gear by running `list_available_resources`, which shows all personnel and equipment listed in your account for optimal assignment across multiple jobs. If you need to check the general details of your account, use `get_account_profile` to pull basic user information. ## Tools ### link_tasks_dependency Creates a required link between two tasks to enforce a start/end sequence. ### create_new_task Adds a new task to your project timeline. ### remove_task Deletes an existing task from the project timeline. ### get_task_checklist Lists all sub-tasks that belong to a parent task. ### get_account_profile Retrieves basic information about your user account. ### get_project_details Fetches detailed information and configuration for a specific project. ### get_task_info Retrieves full details, status, and dates for one specific task. ### list_project_milestones Lists the major, high-level goals set for a project. ### list_projects Retrieves a master list of all projects in your TeamGantt account. ### list_available_resources Shows you all available personnel and equipment listed in your account. ### list_project_tasks Gets a list of all tasks within an entire project timeline. ### update_task_fields Changes a task's status, dates, or completion percentage. ## Prompt Examples **Prompt:** ``` List all active projects in my TeamGantt account. ``` **Response:** ``` I've retrieved your projects. You have 3 active timelines: 'Website Launch Q4', 'New Product Development', and 'Marketing Content Plan'. Which one would you like to check tasks for? ``` **Prompt:** ``` Show me the tasks for 'Website Launch Q4' (ID: 10293). ``` **Response:** ``` I've fetched the tasks. There are 5 pending items including 'Hero Section Design' (50%), 'Fix login bug' (0%), and 'API Integration' (85%). Shall I update the progress for any of these? ``` **Prompt:** ``` Mark task '88231' as 100% complete. ``` **Response:** ``` Task updated! I've set the progress for task 88231 to 100% and updated its status to 'completed' in your TeamGantt project. Your timeline has been synchronized. ``` ## Capabilities ### Track project timelines Get a list of all active projects or pull deep metadata for any specific Gantt chart. ### Manage tasks and status Create, update the dates on, or delete individual tasks within a specified project. ### Define dependencies Link two tasks together to enforce a sequence (e.g., Task A must finish before Task B starts). ### Allocate and list resources List all available users and equipment, helping you optimize team assignment across projects. ### Check project milestones Retrieve a list of major goals or review the checklist for sub-tasks associated with a milestone. ## Use Cases ### Project scope shifts mid-sprint The client just dropped a major new feature. Instead of manually editing 15 tasks and recalculating dates, you ask your agent: 'Add Task Y to Project Alpha.' The agent uses `create_new_task` and intelligently adjusts the surrounding timeline for you. ### Need to check team capacity Before accepting a new contract, you need to know if your developers are free. You run `list_available_resources`. If the agent shows only 2 engineers available, you immediately flag the client that resource allocation is an issue. ### Fixing broken project logic Task B can't start until Task A finishes. You suspect a link is missing. You tell your agent to `link_tasks_dependency` between the two tasks, and it verifies the relationship, preventing scheduling errors. ### Quarterly planning review You need an overview of everything planned for Q4. You ask the agent to 'List all milestones for the next quarter.' The tool runs `list_project_milestones` and gives you a clear, actionable summary instead of just links to a dashboard. ## Benefits - Stop clicking through dashboards. You can update a task's progress or change its due date just by telling the agent, saving you minutes on every single project status report. - Resource planning is instant. Calling `list_available_resources` gives you an immediate inventory of people and gear, so you stop guessing if your team has capacity for that new feature build. - Dependencies are guaranteed. Use `link_tasks_dependency` to enforce hard rules—like 'design must finish before coding starts.' The agent makes sure the timeline logic holds up. - Never lose track of a goal again. Run `list_project_milestones` to see all major project goals and then drill down with `get_task_checklist` for sub-tasks that need attention. - Full Project Visibility: You don't have to open the web app. Use `list_projects` to get a summary of every timeline you manage, making it easy to check which projects are stalled. ## How It Works The bottom line is that you manage your entire project lifecycle using simple text commands instead of clicking through tabs and forms. 1. First, subscribe to the TeamGantt server and input your API Token into your client settings. 2. Next, prompt your agent using natural language—for example: 'Show me tasks for Project X.' 3. The agent calls the necessary tools (`list_project_tasks` or `get_task_info`), pulls the data, and provides a conversational summary. ## Frequently Asked Questions **How do I start a new task with TeamGantt using create_new_task?** Just tell your agent to 'Create a new task called Beta Testing.' The `create_new_task` tool adds it to the project, and you can then use `get_task_info` to check its initial details. **What is the difference between list_project_tasks and get_task_info?** `list_project_tasks` gives you a broad summary of every task in a project. `get_task_info` pulls all the deep, specific metadata—like exact dates or resource owners—for one single task. **Can I link tasks with TeamGantt using link_tasks_dependency?** Yes. You prompt the agent to `link_tasks_dependency` between Task A and Task B. This makes it mandatory that Task A must finish before Task B can start, keeping your timeline clean. **Does TeamGantt have a way to check resource availability?** Use the `list_available_resources` tool. It shows you who's free and what equipment is available so you don't over-allocate people when planning. **How do I use `remove_task` to delete a task from my project?** You must specify the exact Task ID when calling `remove_task`. The tool permanently deletes the item, so double-check that you don't need it first. You can verify the current tasks using `list_project_tasks` before running this command. **What project metadata do I get using `get_project_details`?** This tool returns the core configuration and detailed metadata for an entire project timeline. It shows things like overall project start/end dates, associated departments, and high-level status flags. Use this before managing individual tasks. **Should I use `list_project_milestones` instead of looking at regular tasks?** Milestones represent major, high-level goals that mark significant project stages. They are different from standard tasks because they don't require daily work logs; they just flag completion of a large objective. **How does `update_task_fields` change the status or dates for a task?** `update_task_fields` lets you modify key parameters like the progress percentage, due date range, and overall status. You must provide the Task ID along with the specific fields (e.g., 'status: complete' or 'progress: 75%') in your request. **Can I see all the tasks in a project via AI?** Yes! Use the `list_project_tasks` tool and provide the Project ID. Your agent will retrieve all tasks, milestones, and groups for that specific Gantt chart. **How do I update the progress of a task using the agent?** Use the `update_task_fields` action. Provide the Task ID and the `percentComplete` value (0-100) to update the task's status instantly. **Is it possible to link two tasks with a dependency via AI?** Absolutely. Use the `link_tasks_dependency` tool. Provide the ID of the predecessor and the successor tasks to create a Gantt link between them.