Zoho Projects MCP Server

A Model Context Protocol (MCP) server that provides integration with Zoho Projects API. This server enables AI assistants to interact with Zoho Projects for managing projects, tasks, issues, milestones, and more.

Features

Supported Operations

• Portal Management

  • List all portals
  • Get portal details

• Project Management

  • List projects
  • Get project details
  • Create new projects
  • Update existing projects
  • Delete projects (move to trash)

• Task Management

  • List tasks (portal or project level)
  • Get task details
  • Create tasks
  • Update tasks
  • Delete tasks

• Issue Management

  • List issues (portal or project level)
  • Get issue details
  • Create issues
  • Update issues

• Phase/Milestone Management

  • List phases
  • Create phases

• Search

  • Search across portal or project
  • Filter by module (projects, tasks, issues, milestones, forums, events)

• User Management

  • List users in portal or project

Prerequisites

1. Node.js (v18 or higher)
2. Zoho Projects Account with API access
3. Zoho OAuth Credentials

Setup

1. Get Zoho OAuth Credentials (Detailed Guide)

Step 1: Create a Zoho Developer Application

1. Go to Zoho API Console
2. Click “Add Client” button
3. Choose “Self Client” (recommended for personal use) or “Server-based Applications”
4. Fill in the application details:
   • Client Name: e.g., “Zoho Projects MCP”
   • Homepage URL: Your website or http://localhost for testing
   • Authorized Redirect URIs: http://localhost:8080/callback (or your preferred redirect URL)
5. Click “Create” and note down:
   • Client ID (e.g., 1000.XXXXXXXXXX)
   • Client Secret (keep this secure!)

Step 2: Generate Authorization Code

1. Build the authorization URL with required scopes:

   https://accounts.zoho.{REGION}/oauth/v2/auth?
     scope=ZohoProjects.portals.ALL,ZohoProjects.projects.ALL,ZohoProjects.tasks.ALL,ZohoProjects.bugs.ALL,ZohoProjects.milestones.ALL,ZohoProjects.users.READ,ZohoSearch.securesearch.READ
     &client_id=YOUR_CLIENT_ID
     &response_type=code
     &access_type=offline
     &redirect_uri=YOUR_REDIRECT_URI
   

   Replace {REGION} with your region:

   • US: com
   • EU: eu
   • IN: in
   • AU: com.au
   • CN: com.cn

2. Open this URL in your browser

3. Log in to your Zoho account and authorize the application

4. You’ll be redirected to your redirect URI with a code parameter in the URL:

   http://localhost:8080/callback?code=1000.XXXXX.XXXXX&location=in&accounts-server=https://accounts.zoho.in
   

5. Copy the code value (valid for ~2 minutes, use it immediately!)

Step 3: Exchange Code for Tokens

Use this curl command to get your access and refresh tokens:

curl -X POST https://accounts.zoho.{REGION}/oauth/v2/token \
  -d "code=YOUR_AUTHORIZATION_CODE" \