How to Use the Zoho Desk MCP in Mastra AI

Q: How do I list all existing accounts in Zoho Desk using Mastra AI?

Use the listaccounts tool. It returns the account name, industry, and website for every organization listed in your desk. This is essential context when handling B2B customer support.

Q: What if I need to change a ticket status using Zoho Desk and Mastra AI?

You call updateticket. You specify the existing ticket ID and only pass the fields you want to alter, like changing the status from 'Open' to 'Pending'. It handles the update without touching other data.

Q: Can I find specific customer records in Zoho Desk using Mastra AI?

You can use listcontacts to get a list of names, emails, and phones. If you need one person's history, run getcontact for their details.

Q: Where do I find the department IDs needed for Zoho Desk using Mastra AI?

Run listdepartments. This tool gives you a list of all categories and their unique identifiers. You must use these IDs when creating tickets or listing agents.

Automate complex service desk workflows with Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Zoho Desk MCP to Mastra AI

Create your Vinkius account to connect Zoho Desk to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Zoho Desk with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build multi-step ticket creation

You can't just make a ticket; you need to know where it goes. First, use `list_departments` to get the correct ID. Then, you call `create_ticket`, passing in that department ID along with the subject and contact ID. This ensures the new support case is automatically routed and categorized correctly from the start.

Manage contacts before ticketing

Need to make sure the customer exists? Run `get_contact` first. If not, use `create_contact` with their name and email. You can even add optional details like phone numbers or titles when you create them. This prevents broken workflows where a ticket is opened for an unknown user.

Search and assign tickets automatically

To find work, run `search_tickets` by keyword across descriptions or subjects. Once found, if the status needs changing, you use `update_ticket`. This allows your workflow to reassign a ticket or change its priority based on search results. This is perfect for automated triage.

Setup guide

Set up Zoho Desk MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Zoho Desk tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "zoho-desk-mcp-client",
  servers: {
    "zoho-desk-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Zoho Desk Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Zoho Desk tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Zoho Desk transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Zoho Desk. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Zoho Desk now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Zoho Desk MCP in Mastra AI

Use the `list_accounts` tool. It returns the account name, industry, and website for every organization listed in your desk. This is essential context when handling B2B customer support.

You call `update_ticket`. You specify the existing ticket ID and only pass the fields you want to alter, like changing the status from 'Open' to 'Pending'. It handles the update without touching other data.

You can use `list_contacts` to get a list of names, emails, and phones. If you need one person's history, run `get_contact` for their details.

Run `list_departments`. This tool gives you a list of all categories and their unique identifiers. You must use these IDs when creating tickets or listing agents.

The server touches ticket status, contact names, department details, account association records, and internal notes. It's a full picture of customer interaction history.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript