# Zoho Projects MCP > Zoho Projects manages your entire project lifecycle—from initial concept to completion. Your agent can read project details, list tasks and milestones across multiple portals, create new projects, or update task statuses using natural language commands. It gives your AI client full visibility into team responsibilities and the status of complex organizational workflows. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** task-tracking, milestones, team-collaboration, project-planning, workflow-automation, time-tracking ## Description This MCP lets your agent handle all the messy parts of project management directly from your chat window. Instead of opening up dozens of dashboards to check on status updates or find out who is responsible for a specific deliverable, you just ask your AI client. It connects straight into Zoho Projects, giving it read/write access across all your portals and projects. You can get an overview of every project in one chat session. Need to update a task? You tell your agent what needs changing—like moving a milestone date or setting a status to 'In Review'—and it handles the API calls for you. Because this MCP sits on Vinkius, you connect once and gain access to robust project oversight and team coordination tools that used to take hours of clicking through tabs. ## Tools ### create_project Creates an entirely new project within a specific portal using just its name. ### create_task Adds a brand-new task to a designated project, requiring the portal ID and project ID for context. ### list_milestones Retrieves a list of all scheduled milestones associated with a specific project. ### list_portals Shows every portal available in your account, helping you find the correct ID for subsequent operations. ### list_projects Lists all active projects contained within a single, defined portal. ### list_task_lists Retrieves a list of organized task lists that exist inside a specific project. ### list_tasks Fetches all current tasks associated with a given project ID. ### update_task Changes the status or details of an existing task, supporting updates to only certain fields. ### list_project_users Identifies and lists every single user who has been assigned to a specific project. ## Prompt Examples **Prompt:** ``` List all portals in my Zoho Projects account. ``` **Response:** ``` I've retrieved your portals. You have 2 portals: 'Main Business Portal' (ID: 123456) and 'Client Collaborations' (ID: 789012). Which one would you like to access? ``` **Prompt:** ``` Show me the tasks for project ID '987654' in portal '123456'. ``` **Response:** ``` I found 10 tasks for project 987654. Notable ones include 'Design Final Approval', 'Frontend Implementation', and 'API Integration'. Would you like more details on any of them? ``` **Prompt:** ``` Update task ID '101' in project '987654' to 'Completed' status. ``` **Response:** ``` Successfully updated task 101. Its status has been set to 'Completed' in your Zoho project. ``` ## Capabilities ### Map Project Scope List all available portals and projects within your account so your agent knows where to look for data. ### Manage Tasks Create, retrieve, or update specific tasks in any project, including partial updates to save time. ### Track Deadlines and Milestones List all milestones for a given project, letting you quickly see if key deadlines are on track. ### Build New Projects Instantly create new projects within a specified portal using only the project name and ID. ### Audit Project Teams List every user assigned to a project, giving you clear visibility into team roles and responsibilities. ## Use Cases ### The Quarterly Review A PM needs to prepare a quarterly update showing project health. They ask their agent: 'Show me all projects and list milestones for the top three priority portals.' The agent responds by calling `list_portals` first, then iterating through `list_projects` and finally using `list_milestones` on each one, delivering a consolidated status report in seconds. ### Handling Scope Creep A team lead finds out that Project Alpha needs three new tasks added right away. Instead of opening the project, they tell their agent: 'Create these three tasks immediately for Project Alpha.' The agent uses `create_task` multiple times to ensure nothing falls through the cracks. ### Onboarding a New Member A manager needs to assign responsibilities for a new feature. They ask their agent to 'List all users on Project Beta and then create three follow-up tasks.' The agent calls `list_project_users` first, confirming the team, before executing `create_task`. ### Checking Dependencies A developer needs to know who owns a component. They ask: 'Who is assigned to Project Gamma?' The agent immediately calls `list_project_users`, giving the engineer the exact list of people responsible before they write any code. ## Benefits - Eliminate status report headaches. Instead of manually logging into Zoho Projects to check on milestones, ask your agent to list all required milestones for a project, and get the data instantly. - Maintain perfect team visibility. Use the `list_project_users` tool to pull the full roster of contributors for any project without navigating deep into user management dashboards. - Automate task creation. Need to kick off a new work item? Your agent can use `create_task`, filling in all necessary IDs and names, making manual ticket creation obsolete. - Quickly scope out new initiatives. Don't waste time finding the right container; your agent uses `list_portals` and `list_projects` to help you identify the correct ID for any new project setup. - Keep projects moving forward. Use `update_task` to change a task status or modify details, allowing you to manage the entire workflow pipeline with simple chat commands. ## How It Works The bottom line is, you talk to your AI client like talking to a human assistant who already has credentials and access to your Zoho Project dashboards. 1. First, subscribe to this MCP on Vinkius and enter your Zoho Client ID, Client Secret, and Data Center Domain. 2. Next, connect your preferred AI client (Claude, Cursor, etc.) to the catalog. Your agent now has read/write access credentials for Zoho Projects. 3. Finally, tell your agent what you need—for example, 'List all projects in my main portal'—and it executes the necessary commands. ## Frequently Asked Questions **How do I find all available portals with Zoho Projects MCP?** You use the `list_portals` tool to retrieve a list of every portal in your account. This is the first step needed before you can view projects or tasks within any specific area. **Can I update task status using Zoho Projects MCP?** Yes, you use `update_task` to change a task's status or other details. This tool supports partial updates, so your agent only changes the fields you specify. **Does Zoho Projects MCP let me see who is on a team?** Absolutely. The `list_project_users` tool lets your agent pull every single user associated with a given project, which helps manage responsibilities quickly. **How do I create a new project using Zoho Projects MCP?** You use the `create_project` tool. You just need to provide the target portal ID and the name you want for your new project, and it handles the creation. **What is the difference between list_tasks and list_projects?** The `list_projects` tool shows all major projects inside a single portal. The `list_tasks` tool digs deeper, showing all individual tasks within one specific project.