shadowman-plugins-zoho-tasks/manifest.json

{
  "id": "zoho-tasks",
  "name": "Zoho Tasks",
  "description": "Zoho Projects task management integration for EU data center",
  "version": "1.0.0",
  "author": "Ferenc Szontagh & Zoë",
  "sdkVersion": 1,
  "entry": "index.js",
  "runtime": "quickjs",
  "permissions": {
    "allowNetwork": true,
    "allowStorage": true
  },
  "config": [
    { "key": "client_id", "label": "Zoho OAuth Client ID", "required": true, "secret": true },
    { "key": "client_secret", "label": "Zoho OAuth Client Secret", "required": true, "secret": true },
    { "key": "portal_id", "label": "Zoho Projects Portal ID", "required": true, "secret": false }
  ],
  "tools": [
    {
      "name": "setup_auth",
      "description": "Exchange a Zoho grant token for access + refresh tokens. Run this ONCE after getting a grant token from the Zoho Developer Console.",
      "parameters": {
        "type": "object",
        "properties": {
          "grant_token": { "type": "string", "description": "Grant token from Zoho Developer Console (Self Client → Generate)" }
        },
        "required": ["grant_token"]
      }
    },
    {
      "name": "auth_status",
      "description": "Check authentication status and token validity",
      "parameters": { "type": "object", "properties": {} }
    },
    {
      "name": "list_projects",
      "description": "List all accessible Zoho Projects in the portal",
      "parameters": {
        "type": "object",
        "properties": {
          "index": { "type": "number", "description": "Page index (default 1)" }
        }
      }
    },
    {
      "name": "list_tasks",
      "description": "List tasks from a Zoho Projects project. Supports filtering by status, priority, assignee, and date range.",
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": { "type": "string", "description": "Zoho Projects project ID" },
          "status": { "type": "string", "description": "Filter: all, completed, notcompleted (default: all)" },
          "priority": { "type": "string", "description": "Filter: all, none, low, medium, high" },
          "owner": { "type": "string", "description": "Filter: all or user ID" },
          "index": { "type": "number", "description": "Page index (default 1)" }
        },
        "required": ["project_id"]
      }
    },
    {
      "name": "get_task",
      "description": "Get full details of a single task",
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": { "type": "string", "description": "Zoho Projects project ID" },
          "task_id": { "type": "string", "description": "Task ID" }
        },
        "required": ["project_id", "task_id"]
      }
    },
    {
      "name": "create_task",
      "description": "Create a new task in a Zoho Projects project",
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": { "type": "string", "description": "Zoho Projects project ID" },
          "name": { "type": "string", "description": "Task name/title" },
          "description": { "type": "string", "description": "Task description (HTML allowed)" },
          "person_responsible": { "type": "string", "description": "Owner user ID(s), comma-separated" },
          "priority": { "type": "string", "description": "none, low, medium, high" },
          "start_date": { "type": "string", "description": "Start date (MM-DD-YYYY format)" },
          "end_date": { "type": "string", "description": "Due date (MM-DD-YYYY format)" },
          "tasklist_id": { "type": "string", "description": "Task list ID to add the task to" }
        },
        "required": ["project_id", "name"]
      }
    },
    {
      "name": "update_task",
      "description": "Update an existing task in Zoho Projects",
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": { "type": "string", "description": "Zoho Projects project ID" },
          "task_id": { "type": "string", "description": "Task ID to update" },
          "name": { "type": "string", "description": "New task name" },
          "description": { "type": "string", "description": "New description (HTML allowed)" },
          "person_responsible": { "type": "string", "description": "New owner user ID(s), comma-separated" },
          "priority": { "type": "string", "description": "none, low, medium, high" },
          "start_date": { "type": "string", "description": "New start date (MM-DD-YYYY)" },
          "end_date": { "type": "string", "description": "New due date (MM-DD-YYYY)" },
          "percent_complete": { "type": "string", "description": "Completion percentage (0-100)" }
        },
        "required": ["project_id", "task_id"]
      }
    },
    {
      "name": "delete_task",
      "description": "Delete a task from Zoho Projects",
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": { "type": "string", "description": "Zoho Projects project ID" },
          "task_id": { "type": "string", "description": "Task ID to delete" }
        },
        "required": ["project_id", "task_id"]
      }
    },
    {
      "name": "add_comment",
      "description": "Add a comment to a task",
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": { "type": "string", "description": "Zoho Projects project ID" },
          "task_id": { "type": "string", "description": "Task ID" },
          "content": { "type": "string", "description": "Comment text (HTML allowed)" }
        },
        "required": ["project_id", "task_id", "content"]
      }
    },
    {
      "name": "update_comment",
      "description": "Update an existing comment on a task",
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": { "type": "string", "description": "Zoho Projects project ID" },
          "task_id": { "type": "string", "description": "Task ID" },
          "comment_id": { "type": "string", "description": "Comment ID to update" },
          "content": { "type": "string", "description": "New comment text (HTML allowed)" }
        },
        "required": ["project_id", "task_id", "comment_id", "content"]
      }
    },
    {
      "name": "delete_comment",
      "description": "Delete a comment from a task",
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": { "type": "string", "description": "Zoho Projects project ID" },
          "task_id": { "type": "string", "description": "Task ID" },
          "comment_id": { "type": "string", "description": "Comment ID to delete" }
        },
        "required": ["project_id", "task_id", "comment_id"]
      }
    },
    {
      "name": "my_tasks",
      "description": "Get tasks assigned to the authenticated user across all projects",
      "parameters": {
        "type": "object",
        "properties": {
          "status": { "type": "string", "description": "Filter: all, completed, notcompleted (default: all)" },
          "priority": { "type": "string", "description": "Filter: all, none, low, medium, high" },
          "index": { "type": "number", "description": "Page index (default 1)" }
        }
      }
    },
    {
      "name": "search_tasks",
      "description": "Search tasks by keyword across all projects in the portal",
      "parameters": {
        "type": "object",
        "properties": {
          "query": { "type": "string", "description": "Search term" },
          "project_id": { "type": "string", "description": "Optional: limit search to a specific project" }
        },
        "required": ["query"]
      }
    }
  ],
  "skills": ["zoho-tasks"]
}