← Back to Skills Marketplace
13403
Downloads
3
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install zoho-people
Description
Zoho People API integration with managed OAuth. Manage employees, departments, designations, attendance, leave, and arbitrary Zoho People forms (including custom forms). The forms API provides access to any form configured in the Zoho People account, not only standard HR resources. All write operations require explicit user approval. HR data is sensitive — only access specific records the user explicitly requests. Use this skill when users want to read, create, update, or query HR data in Zoho People. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key. Calls run through the `maton` CLI with OAuth login; default to read and list calls, and confirm every write or new connection with the user.
Usage Guidance
Install only if you intend to let Maton broker access to Zoho People HR data. Prefer OAuth, select the narrowest Zoho scopes available, confirm the target account before writes, and revoke unused connections when finished.
Capability Assessment
Credentials
Network access and Bash use are proportionate to calling the Maton CLI; the skill also says local script execution and credential-file inspection are out of scope.
Install Mechanism
Installation uses the external Maton CLI via npm or Homebrew and OAuth setup; this is coherent for the integration but users should understand they are adding a third-party gateway dependency.
Instruction Scope
Runtime instructions repeatedly require explicit user approval for connection creation and any modifying POST, PUT, PATCH, or DELETE operation, and warn against bulk HR access without justification.
Persistence & Privilege
OAuth tokens or API keys and Zoho People connections persist through the OS credential store and Maton account, but this is disclosed and paired with revocation and least-privilege guidance.
Purpose & Capability
The stated purpose is to access Zoho People HR records, departments, attendance, leave, and custom forms; the documented Maton API capability matches that purpose and clearly discloses sensitivity and full CRUD scope.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install zoho-people - After installation, invoke the skill by name or use
/zoho-people - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.5
- Clarified that the forms API supports access to any form in Zoho People, including custom forms, not just standard HR resources.
- Strengthened security and privacy warnings: All write operations require explicit user approval; access to sensitive HR data is restricted to only specific records the user requests.
- Updated descriptions and headers to distinguish Maton platform endpoints (connection management) from proxied Zoho People API calls.
- Removed sample file skill-card.md.
v1.0.4
- Changed service domain references from gateway.maton.ai and ctrl.maton.ai to api.maton.ai throughout documentation and examples.
- Added a new section for Security & Permissions, clarifying resource access scope and the need for explicit user approval for write operations.
- Improved language for specifying connections, advising users to always include the Maton-Connection header when multiple connections exist.
- Removed the LICENSE.txt file.
v1.0.3
- Added a new `clawdbot` metadata block to the skill manifest, specifying an emoji and an environment variable requirement for `MATON_API_KEY`.
- No changes to code or API functionality; documentation only update.
v1.0.2
- No visible file changes detected in this version.
- Content and functionality appear unchanged from the previous release.
v1.0.1
No changes detected in this release.
- Version updated to 1.0.1.
- No file or documentation changes.
v1.0.0
Initial release of Zoho People API integration with managed OAuth:
- Provides full CRUD operations for employees, departments, designations, attendance, leave, and custom HR forms.
- Easy authentication using Maton API key and managed OAuth—no client credentials required.
- Python code samples for connecting, listing, searching, and managing Zoho People data.
- Supports multiple Zoho People accounts through connection management.
- Includes detailed guidance on specifying active connections and working with both form and view-based APIs.
- Designed for seamless integration with other Maton API Gateway services.
Metadata
Frequently Asked Questions
What is zoho-people?
Zoho People API integration with managed OAuth. Manage employees, departments, designations, attendance, leave, and arbitrary Zoho People forms (including custom forms). The forms API provides access to any form configured in the Zoho People account, not only standard HR resources. All write operations require explicit user approval. HR data is sensitive — only access specific records the user explicitly requests. Use this skill when users want to read, create, update, or query HR data in Zoho People. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key. Calls run through the `maton` CLI with OAuth login; default to read and list calls, and confirm every write or new connection with the user. It is an AI Agent Skill for Claude Code / OpenClaw, with 13403 downloads so far.
How do I install zoho-people?
Run "/install zoho-people" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is zoho-people free?
Yes, zoho-people is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does zoho-people support?
zoho-people is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created zoho-people?
It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.0.
More Skills