Zoho Projects
The Zoho Projects connector lets AI agents browse projects, tasks, milestones, and timesheets, as well as create and update tasks and log time. It uses OAuth 2.0 so your credentials are stored encrypted in MCPGate's vault and are never exposed to the AI client.
Required scopes#
MCPGate requests the following OAuth scopes when you connect a Zoho Projects account.
| Scope | Purpose |
|---|---|
| ZohoProjects.projects.ALL | Read and manage projects and portals |
| ZohoProjects.tasks.ALL | Read, create, update, and complete tasks |
| ZohoProjects.timesheets.ALL | Read timesheets and log time entries |
Tool reference#
The Zoho Projects connector exposes 11 tools. Use the MCP Apps page to enable or disable individual tools per app, and the Guardrails page to add fine-grained rules on top.
| Tool | Category | Description |
|---|---|---|
| zohoprojects_list_portals | read | List Zoho Projects portals accessible to the user |
| zohoprojects_list_projects | read | List projects in a Zoho Projects portal |
| zohoprojects_get_project | read | Get details for a specific Zoho Projects project |
| zohoprojects_list_tasks | read | List tasks in a Zoho Projects project |
| zohoprojects_get_task | read | Get details for a specific Zoho Projects task |
| zohoprojects_list_milestones | read | List milestones in a Zoho Projects project |
| zohoprojects_list_timesheets | read | List timesheet entries for a Zoho Projects project |
| zohoprojects_create_task | write | Create a new task in a Zoho Projects project |
| zohoprojects_update_task | write | Update an existing Zoho Projects task |
| zohoprojects_complete_task | write | Mark a Zoho Projects task as complete |
| zohoprojects_log_time | write | Log time against a Zoho Projects task |
No delete tools
full_access preset without risk of accidental data destruction.Common guardrail recipes#
Read-only access#
Apply the read_only preset to enable the seven read tools and deny all write tools. Useful for project status reporting agents that summarise task progress and milestone dates without making any changes.
Contribute preset#
Use the contribute preset to enable all 11 tools. This allows agents to create tasks, update them, mark them complete, and log time — covering the full task execution workflow.
Restrict to specific projects#
Apply a allow_values guardrail to zohoprojects_create_task and zohoprojects_update_task, targeting the project_id field with the IDs of projects the agent is permitted to modify.
Troubleshooting#
- Portal ID required — Most Zoho Projects API calls are scoped to a portal. MCPGate caches the first portal during OAuth. Use
zohoprojects_list_portalsto confirm the portal ID if tools return "portal not found" errors. - Task ID vs task number — Zoho Projects distinguishes between internal task IDs and user-visible task numbers. Always use the ID returned by
zohoprojects_list_taskswhen calling update or complete tools. - Time log format —
zohoprojects_log_timerequires hours and minutes as separate parameters. Passing a decimal hours value will be rejected. Split the duration before calling the tool.