Zoho Apptics MCP

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:

1. Remote MCP server or a locally hosted MCP server.
2. OAuth support for authentication.
3. 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

1. All organization members can use the MCP integration.
2. Org members can access data only from the Project they have access to in Zoho Apptics.
3. Existing roles & privileges access control apply for MCP integration as well.

Accessing Zoho MCP server

1. Go to https://www.zoho.com/mcp/ and sign up.
2. Once you sign in, go to https://mcp.zoho.com/.
3. 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.

1. 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.

1. A server will be created. Click on Add tools to add Apptics to your server.

1. Select the tools that as per your requirements and click Add now.

1. 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

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.

1. Navigate to claude.ai/settings/integrations
2. Click on Organization integrations.
3. Select Add integration.
4. Enter a name and paste the Integration URL provided from above.
5. Click Add.

Accessing Zoho Apptics MCP Tools in Claude

1. Open a new chat.
2. Choose Search and tools.
3. Pick the Zoho Apptics MCP connection.
4. Select the tools you’d like to use in the chat.
5. 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.

1. {
2. "mcpServers": {
3. "ZohoMCP": {
4. "url": "YOUR_INTEGRATION_URL"
5. }
6. }
7. }

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:

1. Add Zoho Apptics MCP Server.
2. Open Cursor settings (⇧ + ⌘ + J).
3. Go to the MCP Tools tab and click New MCP Server.
4. Copy and paste the following JSON configuration below, then save it using CMD + S or CTRL + S.
5. Activate Agent Mode.
6. 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.

1. {
2. "mcpServers": {
3. "Zoho": {
4. "command": "npx",
5. "args": [
6. "mcp-remote",
7. "YOUR_INTEGRATION_URL",
8. "--transport",
9. "http-only"
10. ]
11. }
12. }
13. }

Configuring Zoho Apptics MCP in Windsurf

1. Open Windsurf settings (⌘ +,).
2. Go to the Cascade tab and click Add Server.
3. Select Add custom server +.
4. 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

1. Open the Visual Studio Code Command Palette (⇧ + ⌘ + P on Mac, Ctrl + Shift + P on Windows).
2. Type "MCP: Add Server..." and press Enter.
3. Choose "HTTP (HTTP or Server-Sent Events)" and press Enter.
4. Paste your MCP key from below into the "Server Key" field and press Enter.
5. Provide a server name and press Enter.
6. Make sure GitHub Copilot is set to Agent mode.
7. 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.

1. {
2. "mcpServers": {
3. "ZohoMCP": {
4. "command": "npx",
5. "args": [
6. "mcp-remote",
7. " https://suptest-122752501.testzohomcp.com/mcp/3da990c773069d237627c05d7e5aa20b/message",
8. "--transport",
9. "http-only"
10. ]
11. }
12. }
13. }

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

1. Open your client's MCP or integrations settings
2. Add a new MCP server — look for Add server, New connection, or a mcp.json config file
3. Set transport to HTTP or Streamable HTTP
4. Paste the MCP URL from above into the server URL field
5. 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

1. Node.js 18 or more.
2. 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.

1. Create a new self-client application from Zoho API console.

2. Generate code with**

   JProxy.jmobileapi.ALL
   

   **scope.

3. Exchange the code for refresh token using the OAuth token endpoint.

4.  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

1. Open Claude desktop.

2. Go to Settings > Developer > Edit config.

3. Add the below mentioned configuration.

4.  {
         "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"
             }
           }
         }
       }
   

5. 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: Total affected users (usercount) Unique crash issues (issuecount) Total crash events (crashecount) Affected devices (devicecount) Crash-free users percentage (crashfreeusers)
getCrashesByDate	Retrieves crash statistics grouped by date and platform. The response contains platform-specific objects (eg: iOS, Android, etc.) each providing daily metrics for: Number of crashes per day (crashcount) Unique devices affected per day (devicecount/deviceschart) Unique users affected per day (usercount/userschart) Unique crashes per day (issuecount/issueschart) Timestamps are returned as UNIX epoch time in milliseconds.
getCrashSummaryWithUniqueMessageId	Retrieves detailed crash metadata and diagnostic trace for a specific crash event. Includes: Device Model and OS version details App context (AppVersion, AppReleaseVersion) Session metadata (SessionStartTime, UserID, DeviceID, NetworkStatus) Crash diagnostic info (Exception, IssueName, Message, CustomProperties)
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. Use group=fatal to view crash trends (daily crash counts over time). Use group=nonfatal or group=error for handled-exception and error trends.
getExceptionCountByGroup	Retrieves the total count of crashes or exceptions for a specific group: Total crash count (fatal errors or app-terminating failures) Total handled/non-fatal exceptions count (non-fatal errors) Logged errors count (JS errors)
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: Logical category/module (event group name) Name of the tracked event (event name) Number of occurrences (events count)
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: Name of the event (event name) Number of occurrences (event count) Epoch timestamp in milliseconds (date)
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

1. Show me a list of all the projects that I can access in Apptics?
2. Fetch the crash summary for the past 7 days?
3. List the active devices that completed payment_made event in the past 30 days.
4. Show me how many and what events occurred on product listing page in the app for the past 7 days.
5. Show me the event distribution by percentage across the platforms.

You can explore more use cases with ready-to-try prompts here.

Create. Review. Publish.

Write, edit, collaborate on, and publish documents to different content management platforms.

Get Started Now

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.

Create, share, and deliver

beautiful slides from anywhere.

Get Started Now

Zoho Sign now offers specialized one-on-one training for both administrators and developers.

BOOK A SESSION

Start tracking your website metrics today

Use PageSense to understand what your visitors are looking for, how they are behaving, and where they are facing problems on your website.

Ready to improve your website's performance?

Install the PageSense code snippet on your site in a matter of minutes and start collecting in-depth data about the website visitors to grow your business.

Track and measure every business goal

Set up goals in PageSense to measure every single action performed by visitors on your website like button or link clicks, form submissions, and page engagements.

Understand the customer journey on your website

Create funnels in PageSense to quickly see which pages visitors use to enter your website, where they navigate to next, and which pages they decide to leave without converting.

Visualize your visitor's behavior with color codes

Set up heatmaps in PageSense to see where users have clicked more, how far they've scrolled, and on which parts of a page they've spent the most time using color-coded patterns in reports.

Measure customer engagement with your web forms

Use form analytics in PageSense to see how people interact with different fields in your form, whether they complete the form successfully or not, and where exactly they drop out on your form.

Record real visitor interactions on your website

Use session recordings in PageSense to watch a video of all the visitor actions performed on your website including the pages they navigate, the buttons they click, the UX issues they face, and more.

Test and optimize webpages for better conversions

Run A/B or Split URL tests in PageSense to figure out which version of your web page works best for your business and results in the best conversion rate.

Give each customer a unique website experience

Use personalization in PageSense to deliver customized versions of your website for every individual customer based on their demographics, local weather, browsing history, and more.

Send timely updates that customers love

Use web push notifications in PageSense to schedule and notify your customers about an upcoming flash sale, product releases, promotional coupons, and a lot more that can spark conversions on your website.

Access more advanced settings in PageSense

Use PageSense's advanced features like creating mutually exclusive groups, enabling cross-domain tracking, configuring customized project JS, and more to get deeper insights about your website.

Try easy-to-use extensions

Download the PageSense extension app available for your web browser with a few clicks and start collecting all of your required website metrics in real time.

Discover your favorite integrations with PageSense

Get a deeper look at your website's data by seamlessly integrating PageSense with a host of popular third-party apps like Google Analytics, Mixpanel, Intercom, and more.

Quick Links	Workflow Automation	Data Collection
Web Forms	Enterprise	Online Data Collection Tool
Embeddable Forms	Banking	Begin Data Collection
Interactive Forms	Workplace	Data Collection App
CRM Forms	Customer Service	Accessible Forms
Digital Forms	Marketing	Forms for Small Business
HTML Forms	Education	Forms for Enterprise
Contact Forms	E-commerce	Forms for any business
Lead Generation Forms	Healthcare	Forms for Startups
Wordpress Forms	Customer onboarding	Forms for Small Business
No Code Forms	Construction	RSVP tool for holidays
Free Forms	Travel	Features for Order Forms
Prefill Forms	Non-Profit
Intake Forms	Legal	Mobile App
Form Designer	HR	Mobile Forms
Card Forms	Food	Offline Forms
Assign Forms	Photography	Mobile Forms Features
Translate Forms	Real Estate	Kiosk in Mobile Forms
Electronic Forms
Drag & drop form builder
Notification Emails for Forms	Alternatives	Security & Compliance
Holiday Forms	Google Forms alternative	GDPR
Form to PDF	Jotform alternative	HIPAA Forms
Email Forms	Formstack alternative	Encrypted Forms
	Wufoo alternative	Secure Forms
	Typeform	WCAG

Zoho FSM Video Tutorials

Workforce

Mobile App

Job Scenarios

Scheduled Maintenance

FSM × Desk

FSM × Books & Invoice

FSM × WhatsApp

MCP Tool Guide MCP Changelog

What's new

Blogs

Community

Zia

API resources

Pricing

Integrations

Town Hall

Custom Apps

Centralize Knowledge. Transform Learning.

All-in-one knowledge management and training platform for your employees and customers.

Access Zoho Learn

Zoho Writer

What's new

Help Guide

Blogs

Forums

Webinars

API

Developers

Build Extensions

Create. Review. Publish.

Write, edit, collaborate on, and publish documents to different content management platforms.

Get Started Now

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.

Features

Survey Templates

Integrations

Community

iOS Mobile Surveys

Pricing

Android Mobile Surveys

Insurvey Blogs

Insight Blogs

Tips & Tricks

Zoho Sheet Resources

Zoho Forms Resources

Latest Announcements

Sign Up

Zoho Sign Resources

Sign, Paperless!

Sign and send business documents on the go!

Get Started Now

Sign Up

Zoho TeamInbox Resources

New to Zoho CPaaS?

LEARN MORE

LEARN MORE

Latest Feature Updates

Access Zoho DataPrep

Design. Discuss. Deliver.

Create visually engaging stories with Zoho Show.

Get Started Now

New to Zoho Workerly?

Access Zoho Workerly

New to Zoho Recruit?

Access Zoho Recruit

Access Zoho CRM

Latest Feature Updates

New to Zoho Projects?

Access Zoho Projects

New to Zoho Sprints?

Access Zoho Sprints

New to Zoho Assist?

Access Zoho Assist

Access Bigin

Latest Feature Updates

• 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...

• 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...

• 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...

• Symbolication using Zoho Apptics

  Overview Symbolicating the crash reports into a human-readable format is essential for any developer to understand the reason behind the crash quickly. What is a dSYM file? A dSYM file is a debug symbol file generated by Apple Xcode along with the...

• 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...

Access Zoho LandingPage

Zoho LandingPage Resources

Bootcamp

Community

Pricing

Webinars

What's New

Integrations

Contact Support

Contact Sales

Resources

Videos

Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.

eBooks

Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.

Webinars

Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.

CRM Tips

Make the most of Zoho CRM with these useful tips.