← Back to Skills Marketplace
byungkyu

zoho-mail

by byungkyu · GitHub ↗ · v1.2.0 · MIT-0
cross-platform ✓ Security Clean
14506
Downloads
8
Stars
0
Active Installs
9
Versions
Install in OpenClaw
/install zoho-mail
Description
Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. 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 are comfortable granting Maton-mediated access to your Zoho Mail account. Use OAuth where possible, select the narrowest Zoho scopes available, confirm every send/delete/modify action before it runs, and revoke unused connections when finished.
Capability Assessment
Credentials
Network access and Bash use are proportionate to calling a mail API through a CLI gateway; the artifact contains no executable scripts and states local script execution is out of scope.
Install Mechanism
Installation uses the third-party Maton CLI via npm or Homebrew, with an SDK and raw HTTPS fallback documented only for environments where the CLI is unavailable.
Instruction Scope
Instructions repeatedly require read/list defaults, explicit user approval for connection creation and all POST/PUT/PATCH/DELETE operations, least-privilege scope selection, and treating fetched email content as untrusted data.
Persistence & Privilege
OAuth/API credentials are stored persistently in the OS credential store or, in fallback mode, read from MATON_API_KEY; the artifact warns not to print, dump, persist elsewhere, or inspect secrets.
Purpose & Capability
The skill can read, send, modify, and delete Zoho Mail data, which is sensitive and high-impact, but those capabilities directly match the stated email-management purpose and are disclosed.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install zoho-mail
  3. After installation, invoke the skill by name or use /zoho-mail
  4. 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.6
- Updated all endpoint URLs to use https://api.maton.ai/ instead of https://gateway.maton.ai/ and https://ctrl.maton.ai/ - Revised connection management instructions to reflect the new endpoints and clarified usage of the Maton-Connection header. - Added a Security & Permissions section emphasizing explicit user approval for write operations. - Removed the LICENSE.txt file from the repository.
v1.0.5
No changes detected in this version. - No updates or modifications were made to the skill.
v1.0.4
- Added "homepage" field to metadata, linking to the Maton homepage. - No other changes detected.
v1.0.3
- Added a new metadata section to declare emoji (🧠) and required environment variable (MATON_API_KEY) under the "clawdbot" key. - No changes to core functionality, API reference, or user instructions. - Documentation and description remain unchanged except for the updated metadata.
v1.0.2
- No changes detected in this version. - Functionality, documentation, and configuration remain the same as the previous release.
v1.0.1
- Skill name corrected from "zohomail" to "zoho-mail" in SKILL.md. - No code or feature changes detected; documentation only.
v1.0.0
- Initial release of Zoho Mail skill with managed OAuth integration. - Send, receive, search, and manage emails, folders, and labels in Zoho Mail via Maton API gateway. - Full documentation on authentication, connection management, and API usage included. - Supports multiple connections with selectable active connection via header. - Examples provided for all major email, folder, and label operations.
Metadata
Slug zoho-mail
Version 1.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 9
Frequently Asked Questions

What is zoho-mail?

Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels. Use this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail. 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 14506 downloads so far.

How do I install zoho-mail?

Run "/install zoho-mail" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is zoho-mail free?

Yes, zoho-mail is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does zoho-mail support?

zoho-mail is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created zoho-mail?

It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.0.

💬 Comments