# Taskworld MCP > Taskworld connects your AI agent to project management workflows, letting you manage workspaces, create projects, and track tasks without leaving your chat interface. Your agent can list all accessible workspaces, update task assignees, or post comments on a specific project—all from natural language prompts. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** task-tracking, project-management, team-collaboration, workflow-automation, taskworld ## Description Listen up. This server connects your AI agent right into Taskworld, giving it the muscle to handle projects and tasks—all from plain language prompts. You don't gotta open a web browser or click through menus; you just talk to your agent, and it gets the job done in your workspace. To get started, your agent first needs credentials. It runs `login` to grab an access token for Taskworld, making sure everything else works smoothly after that initial handshake. Once authenticated, your agent can map out what's available: you can use `list_workspaces` to see every workspace your account has access to. If you need the specifics on one location, calling `get_workspace` pulls all the detailed information for that single Taskworld workspace. When it comes to organizing work, things get real. Your agent handles project lifecycle management. You can kick off a whole new effort by running `create_project`. Need to change something about an existing project—maybe rename it or mark the whole thing as finished? The `update_project` tool lets you manage those details easily. Meanwhile, your agent can list all the projects inside any workspace using `list_projects`, giving you a full rundown of what's running. Managing the actual tasks is where this server shines. First, to get oversight, you can run `list_tasks` against a specific project ID to see every task that’s currently active on it. If a new job pops up, your agent can generate and add a brand new item using `create_task`. You don't just list tasks; you manage them. You can use `update_task` to change critical properties—like shifting the due date, reassigning the task owner, or tweaking the title itself. When a job is done, your agent marks it complete by calling `complete_task`, updating its status instantly. For keeping tabs on progress and history, you've got two tools. You can use `list_comments` to grab every single message posted on either a task or an entire project thread, giving you the whole conversation history right away. If someone needs to talk about it—say, they found a bug or need clarification—your agent posts that comment directly into the flow using `create_comment`. This means all communication stays exactly where it belongs: attached to the specific task or project. Basically, your AI client uses this server to handle everything from initial setup and discovery (`list_workspaces`, `get_workspace`) to building out structure (`create_project`), assigning work (`create_task`, `update_task`), tracking progress (`complete_task`), and keeping the communication loop closed by posting or retrieving messages (`create_comment`, `list_comments`). You'll be able to manage your whole operational pipeline without ever leaving your chat window. ## Tools ### list_comments Gets every comment posted on a specific task, providing the full history. ### complete_task Marks a specified task as finished in Taskworld. ### create_comment Posts a new comment to a specific task or project thread. ### create_project Creates an entirely new project within Taskworld. ### create_task Generates and adds a brand new task to a specified project. ### get_workspace Retrieves detailed information for one specific Taskworld workspace. ### login Authenticates the agent by obtaining a necessary access token for Taskworld. ### list_projects Lists all projects housed within a given workspace. ### list_tasks Retrieves a list of every task associated with a specific project ID. ### update_project Changes project details, like updating the title or marking the entire project as complete. ### update_task Modifies a task's properties, such as changing the assignee, due date, or title. ### list_workspaces Lists all available Taskworld workspaces that your account can access. ## Prompt Examples **Prompt:** ``` List all my Taskworld workspaces. ``` **Response:** ``` I've found 2 workspaces: 'Engineering Team' (ID: 648291) and 'Marketing Dept' (ID: 772930). Which one would you like to explore? ``` **Prompt:** ``` Show me the tasks for project 648291. ``` **Response:** ``` Fetching tasks for project 648291... I found 3 active tasks: 'Update API Documentation', 'Fix Login Bug', and 'Prepare Sprint Review'. Would you like more details on any of these? ``` **Prompt:** ``` Mark task 99283 as completed. ``` **Response:** ``` Task 99283 has been successfully marked as completed. Is there anything else I can help you with? ``` ## Capabilities ### Discover and Organize Workspaces Lists all Taskworld workspaces you have access to, helping your agent narrow down where it needs to focus. ### Manage Project Statuses Creates new projects or modifies existing ones—like changing the title or marking the entire project as finished using `update_project`. ### Control Tasks and Deadlines Creates tasks, retrieves lists of active tasks within a project (`list_tasks`), or updates task properties like assignees and due dates. ### Track Progress and History Retrieves comments on any given task to maintain conversation history, or gets full task lists for oversight. ### Communicate Within Context Posts new messages directly onto a specific project or task thread without needing to open the Taskworld UI. ## Use Cases ### The Daily Standup Report A Team Lead needs to report the status of three projects. Instead of opening three different dashboards, they prompt their agent: 'What's the status on Project Alpha and Beta?' The agent runs `list_tasks` for both, pulls key details, and summarizes it instantly. ### The Late-Night Follow Up A developer finished a complex API endpoint but needs to document the change. They tell their agent: 'Create a new task for documentation on Endpoint X.' The agent runs `create_task` and sets the due date, ensuring nothing slips through the cracks. ### The Project Handover A PM is leaving a project. They ask their agent: 'List all projects in the Engineering team workspace.' The agent runs `list_workspaces` and then `list_projects`, giving them a clean, auditable list to hand off. ### The Accountability Check A manager needs to see who owns a specific feature. They tell their agent: 'Show me all tasks for the user story on authentication.' The agent runs `list_tasks` and provides the full list, identifying ownership via `update_task` details. ## Benefits - **Update Statuses Instantly:** Instead of logging into Taskworld to change a task’s assignee or mark it done, you simply ask your agent. It uses `update_task` or `complete_task` directly from your chat window. - **Keep the Conversation Going:** You don't have to leave your coding environment just to update teammates. Use `create_comment` to post status updates right alongside your code. - **See Everything at a Glance:** Need to know what projects exist? Run `list_workspaces` first, then use `list_projects` to map out all the current initiatives in one go. - **Build Tasks on Demand:** When a developer finishes a piece of work, they can tell their agent to run `create_task`, setting due dates and owners right away. No manual ticket creation needed. - **Audit Project Scope:** Need to know which tasks are assigned to the 'API' feature? Run `list_tasks` for that project ID; it gives you a clean list of everything needing attention. ## How It Works The bottom line is: you talk to your AI client, it runs the tool, and the tool talks back to you with specific project data. 1. Subscribe to the Taskworld server and provide your Personal Access Token. 2. Your AI client calls the tool (e.g., `list_workspaces`) by passing a natural language request. 3. The server executes the action, returns structured data (like a list of projects or tasks), and your agent reports the results back to you. ## Frequently Asked Questions **How do I get started with Taskworld using the create_task tool?** First, run `list_workspaces` to identify your workspace ID. Then, use a natural language prompt like: 'Create a task called X for Project Y.' The agent handles the rest. **Is there a way to check all projects in my account? (list_projects)** You must first tell your agent which workspace you want to check. Run `list_workspaces`, then use the ID from that list when asking it to run `list_projects`. **What's the difference between create_task and update_task?** `create_task` makes a brand new item on the board. `update_task` changes properties of an existing task, like changing its assignee or setting a new due date. **Can I list all my projects with one command? (list_projects)** No. You first need to run `list_workspaces` and select the correct workspace ID before running `list_projects`. The tools are scoped by workspace. **What's the first step before I can use any task management tools like `create_project`?** You must run the `login` tool first. This action authenticates your connection and provides a necessary access token. You need this token to authorize all subsequent calls, whether you’re listing workspaces or creating tasks. **If I want to track changes on a specific task, how do I use the `list_comments` tool?** The `list_comments` tool fetches every comment associated with a single task ID. It doesn't just show the latest one; it pulls the complete conversation history for that specific item. **How do I find all my available workspaces before listing projects using `list_projects`?** `list_workspaces` shows you every high-level container Taskworld uses. You must select a workspace ID first, as subsequent tools like `list_projects` operate within that defined scope. **What happens if I run the `update_task` tool with an incorrect assignee or due date format?** The system validates your input against Taskworld's required schema. If any field is formatted incorrectly, the tool will fail and return a specific error message detailing which piece of data needs fixing. **Can I update task points and due dates through the AI?** Yes! You can use the `update_task` tool to modify task properties including titles, descriptions, assignees, due dates, and points. **How do I see the discussion or comments on a specific task?** Simply use the `list_comments` tool with the specific Task ID. The AI will retrieve all comments associated with that task. **Is it possible to create a new project directly from the chat?** Yes, the `create_project` tool allows you to instantiate a new project within a specific workspace by providing a title.