# Workast MCP MCP > Workast MCP connects project management, task tracking, and team coordination directly into your agent workflow. It lets you manage entire work environments—from creating new project spaces to assigning specific tasks to users—without ever leaving your chat client. Stop switching apps just to update a status or check who owns a deliverable; this handles the whole backlog. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** task-tracking, workflow-automation, team-collaboration, project-backlog, deadline-management ## Description You can use this connector to run complex workflows across your organization's entire project structure. Instead of jumping between Workast, email, and your task tracker, you tell your agent what needs doing—like 'Update all Q3 marketing tasks for Design Team'—and it handles the whole sequence. You can organize work by creating new spaces or managing existing ones; assign tasks, update due dates, and even delete old records programmatically. Furthermore, you can look up team member details using `get_user` and check who is assigned what via `list_users`. This means your agent doesn't just pull data; it acts on it. Because the workast platform handles all infrastructure and updates, and Vinkius manages the execution through a zero-trust proxy, your credentials are used only in transit and never stored on disk. The real value comes when you chain this MCP with other tools—like connecting project task status to a billing system—allowing one AI agent to automate processes that normally span multiple platforms. ## Tools ### create_space Generates an entirely new, isolated workspace for a project or team. ### create_task Adds a specific new item to the task backlog with all necessary details and due dates. ### delete_task Removes a task from its current space, cleaning up old records. ### get_account_profile Retrieves core profile information tied to your Workast account setup. ### get_space Fetches all details about one specific project or work area. ### get_task Gets the full status and history of a single task item. ### get_team_info Retrieves high-level data about the team structure and composition. ### get_user Pulls detailed profile information for any specific user in your organization. ### list_spaces Provides a complete list of every existing workspace you have created or been added to. ### list_tasks Shows all current task items within a defined space boundary. ### list_users Retrieves a directory listing of all team members available in Workast. ### update_task Changes the status, assignee, or description of an existing task item. ## Prompt Examples **Prompt:** ``` List all active spaces in my Workast account. ``` **Response:** ``` I've retrieved your spaces. You have 4 active environments: 'Project Alpha', 'Design Team', 'Marketing Q4', and 'Customer Support'. Which one should I inspect? ``` **Prompt:** ``` Show me the tasks currently in the 'Design Team' space. ``` **Response:** ``` Fetching tasks... I've found 6 pending items in the Design Team space. Top tasks include 'Update UI Kit' (Due: tomorrow) and 'Review Logo Drafts'. ``` ## Capabilities ### Build Project Environments Create entire work spaces, or 'spaces,' for specific teams and initiatives. ### Manage Tasks Generate new tasks with due dates and descriptions, or update the status of existing items using `update_task`. ### Track Progress Get detailed lists of all active spaces and all pending tasks within a specified project area. ### Coordinate Teams List team members to assign responsibility or retrieve specific user profiles using `get_user`. ### Audit Project Data Retrieve metadata about the entire account, ensuring your agent always works with the most current organizational data. ## Use Cases ### The Onboarding Bottleneck A new team member needs to be added to three active projects. Instead of manually calling the PM and updating tasks in multiple places, you tell your agent to use `list_users` first, then run a sequence that calls `create_space` for the needed areas and assigns them using `update_task`. ### The End-of-Quarter Audit You need a report on all tasks in the 'Marketing Q4' space that were assigned to someone who left last month. Your agent can use `list_tasks` combined with `get_user` to filter out inactive accounts, giving you a clean list for HR. ### The Scope Creep Cleanup A project space has grown messy with old tasks nobody needs. You ask the agent to inspect the 'Design Team' space using `get_space`, and it recommends deleting unnecessary items via `delete_task`. ### The Status Check You need a quick overview of all ongoing work for a client. You ask your agent to use `list_spaces` followed by `get_task` on the top five spaces, giving you instant status reports without clicking anything. ## Benefits - Stop manually updating status reports. You can use the `update_task` tool to change due dates or assignees across multiple tasks at once, just by asking your agent. - Never lose track of a project's scope again. The `list_spaces` capability lets you see every active environment, so you know exactly where the work is happening. - Know who owns what instantly. By combining `get_user` and `list_users`, your agent can build out full team dependency maps for any given project space. - Maintain clean data hygiene. You can use `delete_task` to remove stale, completed items from the backlog, keeping your active task lists accurate and short. - Keep everything current using `get_account_profile`. Your agent always checks your core organizational metadata before making changes, preventing outdated work. ## How It Works The bottom line is that your AI client manages the connection and talks to Workast on your behalf, so you don't have to touch the platform directly. 1. First, connect Workast to your AI client and provide an API token from your Workast settings. 2. Next, tell your agent exactly what you need; for example, 'List all spaces that contain tasks due this week.' 3. Your agent executes the necessary calls—like `list_spaces` followed by `list_tasks`—and gives you a plain text summary of the status. ## Frequently Asked Questions **How do I list all my project spaces using the Workast MCP?** You run a simple request for `list_spaces`. This tool gives you an immediate directory of every active project environment in your account, letting you see what’s available to work with. **Can I update tasks across different projects? (Workast MCP)** Yes, if you know the task ID and space ID. You use `update_task` after first getting the context by calling `get_space`. This keeps your changes scoped correctly. **What is the best way to check a user's info? (Workast MCP)** Use `get_user` for specific details on one person, or use `list_users` if you need a full roster of who is available in your team. **How do I check tasks in a specific area using the list_tasks tool?** It retrieves all items within a defined space. You need to provide the Space ID and optionally date parameters, which ensures you only get relevant pending work. **What is the difference between listing users with list_users and getting an individual user's details?** The `list_users` tool pulls a complete roster of team members. Use this when you need to review group composition or perform bulk actions, not just single profiles. **What specific metadata can I get using the get_space tool?** This tool provides comprehensive data about an entire work area. You'll find details like its owner, creation date, and current total member count. **How do I remove a task that was accidentally created using delete_task?** You must supply the full Task ID along with the Space ID to confirm deletion. The system handles errors if the specified item doesn't exist in the space. **What data points are included when I use get_account_profile?** It fetches your core account information, including your registered email and name. This is useful for syncing user identity into external reports or logs. **How do I generate a Workast API Token?** Log in to Workast, go to your profile icon, select **Preferences** > **API**, and click 'Generate new token' to create your unique access credential. **What is a 'Space' in Workast?** A Space is a container for your task lists. It is typically used to organize different projects, client work, or team-specific channels within your workspace.