Shamshadzz/zoho-mcp-server

Zoho MCP Server

This project provides a Model Context Protocol (MCP) server for interacting with Zoho People, allowing you to submit and retrieve Daily Status Reports (DSR) and manage projects via a standardized interface.

Features

• Submit DSR entries to Zoho People
• Retrieve DSR history for a date range
• List available projects
• Auto-fill DSR entries based on patterns and previous entries

Prerequisites

• Node.js (v18 or higher recommended)
• npm (comes with Node.js)
• Zoho People API credentials (Client ID, Client Secret, Refresh Token, Org ID)

Setup

1. Clone the repository

   git clone <your-repo-url>
   cd zoho-mcp-server
   

2. Install dependencies

   npm install
   

3. Configure environment variables Create a .env file in the root directory with the following content:

   ZOHO_CLIENT_ID=your_zoho_client_id
   ZOHO_CLIENT_SECRET=your_zoho_client_secret
   ZOHO_REFRESH_TOKEN=your_zoho_refresh_token
   ZOHO_ORG_ID=your_zoho_org_id
   ZOHO_BASE_URL=https://people.zoho.com  # Optional, defaults to this value
   

Running the Server

To start the MCP server:

npm start

Or, if you want to run directly with ts-node (for development):

npx ts-node src/index.ts

The server will run using stdio transport and is ready to accept MCP requests.

Project Structure

• src/index.ts - Main server entry point
• src/zoho-client.ts - Zoho People API client logic
• src/types.ts - Type definitions

License

MIT

Using This Server as a Tool Provider in Claude AI Desktop

You can connect this MCP server to Claude AI Desktop (or any Claude client that supports MCP stdio tool providers) to enable Claude to use Zoho People tools.

Steps:

1. Start the MCP server

   • Open a terminal in your project directory and run:

     npm start
     

     or (for development):

     npx ts-node src/index.ts
     

2. Configure Claude AI Desktop to use your MCP server as a tool provider

   • In Claude AI Desktop, go to the settings or tool integrations section.
   • Add a new MCP tool provider and set the command to launch your server. For example:
     • Command: node dist/index.js (if you have built the project)
     • Or: npx ts-node src/index.ts (for TypeScript source)
     • Set the working directory to your project folder.

3. Use the tools in Claude

   • Once configured, you can ask Claude to use the tools by natural language prompts, e.g.:
     • "Get my DSR history for last week."
     • "Submit a DSR for today."
   • Claude will call the appropriate tool on your MCP server and use the result in its response.

Note:

• The server communicates via stdio, not HTTP. Make sure only one instance is running and that the working directory is correct.
• You can view the available tools and their required parameters in the src/index.ts file or by inspecting the tool list in Claude's UI.