Zoho Sprints
The Zoho Sprints connector lets AI agents manage agile project workflows — browsing projects, sprints, and backlog items, creating and updating work items, and logging 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 Sprints account.
| Scope | Purpose |
|---|---|
| ZohoSprints.projects.ALL | Read and manage projects and sprints |
| ZohoSprints.items.ALL | Read, create, and update work items; log time |
Tool reference#
The Zoho Sprints 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 |
|---|---|---|
| zohosprints_list_projects | read | List all projects in Zoho Sprints |
| zohosprints_get_project | read | Get details of a specific Zoho Sprints project by ID |
| zohosprints_list_sprints | read | List all sprints in a Zoho Sprints project |
| zohosprints_get_sprint | read | Get details of a specific sprint by ID |
| zohosprints_list_items | read | List work items in a Zoho Sprints sprint |
| zohosprints_get_item | read | Get details of a specific work item by ID |
| zohosprints_list_backlog | read | List backlog items for a Zoho Sprints project |
| zohosprints_create_item | write | Create a new work item in a Zoho Sprints sprint or backlog |
| zohosprints_update_item | write | Update an existing work item in Zoho Sprints |
| zohosprints_complete_sprint | write | Mark a Zoho Sprints sprint as complete |
| zohosprints_log_time | write | Log time spent on a work item in Zoho Sprints |
Completing a sprint moves incomplete items to backlog
zohosprints_complete_sprint closes the sprint and automatically moves any unfinished work items to the project backlog. This affects team velocity metrics and sprint reports. Ensure the team has reviewed all items before the agent calls this tool.Common guardrail recipes#
Read-only access#
Apply the read_only preset to enable the seven read tools and deny all write tools. Suitable for sprint review or reporting agents that summarise velocity, backlog size, and sprint progress without modifying any items.
Contribute preset#
Use the contribute preset to enable all tools except zohosprints_complete_sprint. This lets developer agents create items, update status, and log time without being able to close an active sprint.
Full access#
The full_access preset enables all 11 tools. Apply a allow_values guardrail to zohosprints_complete_sprint targeting the project_id field to restrict which projects the agent is permitted to close sprints in.
Troubleshooting#
- Project ID vs project name — Zoho Sprints uses numeric project IDs in the API. Use
zohosprints_list_projectsto retrieve the correct ID before calling sprint or item tools. - Item type required —
zohosprints_create_itemrequires an item type (e.g. story, task, bug). Item types are project-specific — check your Zoho Sprints project configuration for available types. - Time log format —
zohosprints_log_timeexpects hours and minutes as separate integer values. Passing a decimal value will cause a validation error.