Zoho Apptics MCP server
Overview
Zoho Apptics Model Context Protocol (MCP) server helps teams to analyze product data such as usage, engagement, performance stats using conversational AI. Query data directly through AI interfaces (Claude, Cursor, etc.) using natural language without any SQL queries or deep analysis of the dashboard. Zoho Apptics MCP is built on Zoho MCP, so you need to access Zoho MCP and create a server to access Zoho Apptics MCP.
Zoho Apptics MCP server supports the MCP features:
- Remote MCP server or a locally hosted MCP server.
- OAuth support for authentication.
- 42 tool calls & prompts for bringing more context to the Apptics data in your LLM.
Note: Zoho Apptics MCP server is under BETA phase. Some functions may not be available and you may experience some bugs during this period. Remote MCP server
Getting started
Permissions and access control
- All organization members can use the MCP integration.
- Org members can access data only from the Project they have access to in Zoho Apptics.
- Existing roles & privileges access control apply for MCP integration as well.
Accessing Zoho MCP server
- Go to https://www.zoho.com/mcp/ and sign up.
- Once you sign in, go to https://mcp.zoho.com/.
- Click on Create MCP server. You will see a list of pre-configured servers tailored for different use cases. Select Zoho Apptics from the drop down to filter out Apptics-specific pre-configured servers.
- You can also create your own custom MCP server and configure the required tools as per your use case. Click on Create MCP server and give a name for your server and click create.
- A server will be created. Click on Add tools to add Apptics to your server.
- Select the tools that as per your requirements and click Add now.
- Click on Connect in the left menu to add Apptics MCP to your LLM.
Implementation
Complete the steps given below, based on the LLM tool you are using.
Claude
Cursor
Windsurf
VS Code
Any other MCP client
Claude
Connect Zoho Apptics MCP to Claude
Link Claude with Zoho Apptics MCP, allowing it to handle real-world workflows through a secure, straightforward setup—all within your conversation window.
Setting Up Zoho Apptics MCP in Claude
Note: Only a Claude organization admin can complete these steps. Once connected, the integration will be accessible to everyone in your Claude organization, but only you can manage the tools linked to this Zoho Apptics MCP instance.
- Navigate to claude.ai/settings/integrations
- Click on Organization integrations.
- Select Add integration.
- Enter a name and paste the Integration URL provided from above.
- Click Add.
Accessing Zoho Apptics MCP Tools in Claude
- Open a new chat.
- Choose Search and tools.
- Pick the Zoho Apptics MCP connection.
- Select the tools you’d like to use in the chat.
- Ask Claude to perform actions using them!
Cursor
Connect Zoho Apptics MCP to Cursor
Use tools from Zoho Apptics MCP directly inside Cursor IDE. Enable your AI assistant to perform real-world actions securely—without leaving your coding workspace.
- {
- "mcpServers": {
- "ZohoMCP": {
- "url": "YOUR_INTEGRATION_URL"
- }
- }
- }
Setting Up Zoho Apptics MCP in Cursor
You can first try clicking the "Add to Cursor" button for automatic setup. If manual installation is needed, follow these steps:
- Add Zoho Apptics MCP Server.
- Open Cursor settings (⇧ + ⌘ + J).
- Go to the MCP Tools tab and click New MCP Server.
- Copy and paste the following JSON configuration below, then save it using CMD + S or CTRL + S.
- Activate Agent Mode.
- Make sure the chat is set to Agent mode to access Zoho Apptics MCP tools within Cursor.
Important: Treat your MCP server key like a password. It can trigger tools connected to your account and access sensitive information.
Windsurf
Windsurf icon connect to Zoho Apptics MCP
Use Zoho Apptics MCP directly within Windsurf IDE. Let your AI assistant handle real-world actions through a secure, simple connection-right from your coding environment.
- {
- "mcpServers": {
- "Zoho": {
- "command": "npx",
- "args": [
- "mcp-remote",
- "YOUR_INTEGRATION_URL",
- "--transport",
- "http-only"
- ]
- }
- }
- }
Configuring Zoho Apptics MCP in Windsurf
- Open Windsurf settings (⌘ + ,).
- Go to the Cascade tab and click Add Server.
- Select Add custom server +.
- Add the following JSON configuration, replacing the placeholder key with your MCP key from below.
Note: Treat your MCP server key like a password! It can trigger tools linked to this server and access your data.
VS Code
Connect to Visual Studio Code
Use tools directly inside Visual Studio Code with Zoho Apptics MCP. Allow your AI assistant to perform real-world actions through a secure, simple connection—without leaving your coding workspace.
Important: You must have GitHub Copilot enabled and set to Agent mode in Visual Studio Code for Zoho Apptics MCP to function correctly.
Configuring Zoho Apptics MCP in Visual Studio Code
- Open the Visual Studio Code Command Palette (⇧ + ⌘ + P on Mac, Ctrl + Shift + P on Windows).
- Type "MCP: Add Server..." and press Enter.
- Choose "HTTP (HTTP or Server-Sent Events)" and press Enter.
- Paste your MCP key from below into the "Server Key" field and press Enter.
- Provide a server name and press Enter.
- Make sure GitHub Copilot is set to Agent mode.
- Ask GitHub Copilot to use tools from your Zoho Apptics MCP server!
Caution: Treat your MCP server key like a password! It can trigger tools linked to your server and access sensitive data.
Any other MCP client
Works with any MCP-compatible client
If your AI agent, IDE, or automation tool supports the Model Context Protocol, paste the URL from above and you're done. No special setup needed beyond what your client requires.
- {
- "mcpServers": {
- "ZohoMCP": {
- "command": "npx",
- "args": [
- "mcp-remote",
- "https://suptest-122752501.testzohomcp.com/mcp/3da990c773069d237627c05d7e5aa20b/message",
- "--transport",
- "http-only"
- ]
- }
- }
- }
Warning: Treat this URL like a password. It can trigger tools linked to your account and access your data. Don't paste it into public repos, shared docs, or anywhere others can read it.
Transport type
Zoho MCP uses HTTP (Streamable HTTP) transport. Select this if your client asks you to choose: HTTP / Streamable HTTP
JSON config snippet
If your client accepts a JSON config file (common in IDE-based agents), paste this block:
General connection steps
- Open your client's MCP or integrations settings
- Add a new MCP server — look for Add server, New connection, or a mcp.json config file
- Set transport to HTTP or Streamable HTTP
- Paste the MCP URL from above into the server URL field
- Save and enable Agent mode or equivalent in your client
Note: Clients known to work with Zoho MCP include Zed, Continue, Cline, n8n, and others that support Streamable HTTP transport. If yours isn't listed and the steps above don't work, check your client's MCP documentation or write to us at support@zohomcp.com.
Locally hosted MCP server
Requirements
- Node.js 18 or more.
- Zoho Apptics OAuth credentials, i.e., client ID, client secret, and a refresh token with access to Apptics APIs.
Auth credentials
To configure Zoho Apptics local MCP server, you need to provide OAuth credentials (client id, client secret, and refresh token) as environment variables.
- Create a new self-client application from Zoho API console.
- Generate code with JProxy.jmobileapi.ALL scope.
- Exchange the code for refresh token using the OAuth token endpoint.
curl -X POST "https://accounts.zoho.com/oauth/v2/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "code=YOUR_SELF_CLIENT_CODE" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET" \
-d "grant_type=authorization_code"
The JSON response includes refresh_token; supply the refresh token via APPTICS_REFRESH_TOKEN. For other Zoho data centers, switch accounts.zoho.com to accounts.zoho.eu, accounts.zoho.in, etc.
Environment variables
Variable | Required | Description |
| APPTICS_CLIENT_ID | Yes | OAuth client ID created in the Zoho API console |
APPTICS_CLIENT_SECRET | Yes | OAuth client secret for the Zoho self-client |
APPTICS_REFRESH_TOKEN | Yes | Refresh token with JProxy.jmobile.ALL scope used to obtain access token |
APPTICS_SERVER_URI | No | Override for Apptics API base URL (defaults to https://apptics.zoho.com). Use the regional domains if needed |
APPTICS_ACCOUNTS_URI | No | Override for Zoho accounts OAuth base URL (defaults to https://accounts.zoho.com). Switch to accounts.zoho.eu or accounts.zoho.in, etc. for other data centers |
Claude desktop configuration
- Open Claude desktop.
- Go to Settings > Developer > Edit config.
- Add the below mentioned configuration.
{
"mcpServers": {
"zoho-apptics": {
"command": "npx",
"args": ["@zoho_apptics/apptics-mcp"],
"env": {
"APPTICS_CLIENT_ID": "your_client_id",
"APPTICS_CLIENT_SECRET": "your_client_secret",
"APPTICS_REFRESH_TOKEN": "your_refresh_token"
}
}
}
}
- Restart Claude desktop app.
Zoho Apptics MCP tools
The MCP integration provides access to the core capabilities of Apptics:
Tool name | Description |
| getUserProjects | Retrieves the list of project associated with the authenticated user |
getProjectDetails | Retrieves detailed information about a specific project including name, creation date, configured platforms, and settings. |
getDashboardApplications | Retrieves application details for the dashboard view such as app name, bundle ID, platform, and status. |
| getCrashList | Returns a list of crash summaries for a given date range, optionally filtered by appversion and platform. Each entry includes metadata such as app version, OS type, number of affected users and devices, crash count, and a top-level exception signature. |
| getCrashSummary | Retrieves a summarized view of crash statistics including:
|
| getCrashesByDate | Retrieves crash statistics grouped by date and platform. The response contains platform-specific objects (eg: iOS, Android, etc.) each providing daily metrics for:
Timestamps are returned as UNIX epoch time in milliseconds. |
| getCrashSummaryWithUniqueMessageId | Retrieves detailed crash metadata and diagnostic trace for a specific crash event. Includes:
|
getCrashCountByDateWithTimezone | Similar to getCrashesByDate but allows timezone-based time interval grouping. The response provides platform-specific daily crash metrics adjusted to the specified timezone. |
getCrashCountByDateForUnique | Retrieves date-wise crash count statistics for a specific crash issue identified by its unique ID. Useful for tracking the frequency trend of a particular crash over time. |
getCrashCountByDateWithTimezoneForUnique | Retrieves date-wise crash count statistics with timezone support for a specific crash issue. Combines per-issue filtering with timezone-adjusted date grouping. |
getCrashDeviceModelData | Retrieves device model distribution data for a specific crash issue. Shows which device models are most affected. It is useful for identifying hardware-specific issues. |
getCrashOsVersionData | Retrieves OS version distribution data for a specific crash issue. Shows which OS versions are most affected. It is useful for identifying OS-specific regressions. |
getCrashAffectedDevices | Retrieves the list of affected devices for a specific crash issue. Shows individual device details that experienced this crash. It is useful for support and debugging workflows. |
getExceptionChart | Retrieves time-series chart data for crashes and exceptions.
|
getExceptionCountByGroup | Retrieves the total count of crashes or exceptions for a specific group:
|
getExceptionReportsV2 | Retrieves the V2 crash and exception report list. When group=fatal, returns the crash report list — each row represents a unique crash issue with its issue name, exception signature, affected app versions, total crash count, and affected user/device counts. |
getUniqueExceptionCount | Retrieves the count of unique occurrences for a specific crash or exception issue. Use exceptionGroup=fatal to count crash occurrences. |
getUniqueExceptionTrace | Retrieves the full stack trace for a specific crash or exception. The symbolicated trace includes method calls, file names, line numbers, and thread information and acts as a primary debugging tool. |
getUniqueExceptionChart | Retrieves time-series trend data for a specific crash or exception issue. Shows how occurrence frequency changes over time . It is useful for monitoring regressions after releases. |
getUniqueExceptionDeviceDetailsChart | Retrieves device-model and OS-version distribution data for a specific crash or exception issue. It is useful for determining if a crash is hardware-specific or OS-specific. |
getExceptionDevices | Retrieves the list of individual devices affected by a specific crash or exception. Returns per-device records including device model, OS version, app version, and crash timestamps. |
getAnrCountByDate | Retrieves ANR statistics grouped by date. ANRs are Android-specific 'App Not Responding' errors that occur when the main thread is blocked for too long. |
getAnrSummary | Retrieves a summarized view of ANR statistics including total ANR count, affected users, devices, and issue counts. |
| getEventSummary | Returns a platform-wise summary of custom events. Each event object includes:
|
| getEventCountrywiseSummary | Retrieves event activity grouped by country. Returns a flat mapping of country names to their corresponding event counts. |
| getEventDeviceCount | Retrieves the count of unique active devices that triggered specific custom events. Returns a mapping where each key is an event label and the value is the number of unique devices. |
| getEventCountByDate | Retrieves event activity grouped by date and platform. Each event entry includes:
|
| getAllEventStats | Retrieves event count summaries aggregated across one or two grouping dimensions such as date, platform, country, app version, or device type. |
searchEvents | Searches for specific custom events from the BDaaS data store. Allows filtering by event name, group name, platform, and date range. |
| getAllScreenStats | Retrieves the count of screen views aggregated by one or two grouping dimensions such as date, platform, country, app version, or device type. |
getScreenRetentionStats | Retrieves retention statistics based on screen views. Analyzes how users return to specific screens over time at day, week, or month granularity. |
getAllSessionStats | Retrieves session count statistics aggregated by one or two grouping dimensions such as date, platform, app version, country, device type). |
| getAllApiStats | Retrieves the usage stats for configured APIs aggregated by grouping dimensions such as platform, date, app version, country, or device type. |
| getAllActiveDeviceStats | Retrieves the number of unique active devices grouped by one or two dimensions such as date, platform, app version, country, bundle, device type. |
| getActiveDeviceCountByDate | Retrieves the daily count of unique active devices for each platform. Each date is returned as a UNIX epoch timestamp in milliseconds. |
getRemoteLoggerStats | Retrieves remote logging statistics. Remote logs are diagnostic logs sent from devices that can be filtered by function name, log message, severity level, device model, device ID, and user. |
getRemoteLoggerSummary | Retrieves a summarized/aggregated view of remote logging statistics. Provides high-level counts and breakdowns by severity level, function, device, and user. |
getAllStoreReviewAppConfigurations | Returns the store app configuration metadata such as the configured Play Store and App Store apps, their AAIDs, package names, bundle IDs, etc. for the current project. |
getAllStoreReviewAppVersions | Returns the available app versions for the specified Play Store and/or App Store app IDs. |
getAllStoreReviewsList | Retrieves a paginated list of reviews from both Play Store and App Store. Supports filtering by date range, star rating, sentiment, country, language, reply status, spam classification, device info, app versions, and custom tags. Returns reviewer name, review text, rating, date, device info, and developer response if any. |
getAllStoreReviewsTrend | Retrieves the review trend over time for combined Play Store and App Store reviews. Returns review count data grouped by date. |
getAllStoreReviewsGroupStats | Retrieves grouped statistics for combined Play Store and App Store reviews. The required groupby parameter determines the aggregation dimension. |
Example use cases
- Show me a list of all the projects that I can access in Apptics?
- Fetch the crash summary for the past 7 days?
- List the active devices that completed payment_made event in the past 30 days.
- Show me how many and what events occurred on product listing page in the app for the past 7 days.
- Show me the event distribution by percentage across the platforms.
You can explore more use cases with ready-to-try prompts here.
Access your files securely from anywhere
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
Centralize Knowledge. Transform Learning.
All-in-one knowledge management and training platform for your employees and customers.
New to Zoho Writer?
Create. Review. Publish.
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Getting started with Zoho Apptics
Getting Started Welcome to Zoho Apptics! The right place for your apps. Zoho Apptics is the privacy-friendly product analytics solution that provides you with in-app usage, engagement, performance, and growth monitoring for your mobile, web, and ...Jira integration in Zoho Apptics
Overview Jira integration lets you convert real-time app crashes and non-fatal issues into Jira issues directly from Zoho Apptics. This helps development and QA teams track, prioritise, and resolve issues efficiently within their existing Jira ...Microsoft Teams integration with Zoho Apptics
The Microsoft Teams integration in Zoho Apptics allows you to receive real-time alerts directly in your Teams channels for critical events such as crashes and in-app feedback. This helps your team stay informed and respond quickly without needing to ...Zoho Projects integration in Zoho Apptics
Overview Zoho Projects integration helps you carry out your day-to-day tasks effectively. You can assign any crashes, non-fatal, in-app feedback, or store reviews that you receive for the app as bugs and track their progress. You will be able to do ...Zoho Desk integration in Zoho Apptics
Overview Zoho Desk integration with Apptics enables you to manage any feedback received from the app as a support ticket. You can assign any feedback, bug, help, or issues that the app receives as a support ticket. All you need is a setup in Zoho ...
New to Zoho LandingPage?
Zoho LandingPage Resources