Skip to main content 首页 创作者 dvcrn openclaw-skills-marketplace zoho-calendar
zoho-calendar Zoho Calendar API integration with managed OAuth. Manage calendars and events with full scheduling capabilities.
Use this skill when users want to read, create, update, or delete calendar events, manage calendars, or schedule meetings.
For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Requires network access and valid Maton API key.
跳到安装 Skills Marketplace 发现并探索由社区构建的 Agent Skills
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/dvcrn/openclaw-skills-marketplace --skill zoho-calendar命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
下载 Zip 下载中... name zoho-calendar description Zoho Calendar API integration with managed OAuth. Manage calendars and events with full scheduling capabilities.
Use this skill when users want to read, create, update, or delete calendar events, manage calendars, or schedule meetings.
For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Requires network access and valid Maton API key.
Zoho Calendar
Access the Zoho Calendar API with managed OAuth authentication. Manage calendars and events with full CRUD operations, including recurring events and attendee management.
Quick Start
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-calendar/api/v1/calendars' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Base URL
https://gateway.maton.ai/zoho-calendar/api/v1/{endpoint}
The gateway proxies requests to calendar.zoho.com/api/v1 and automatically injects your OAuth token.
Authentication
All requests require the Maton API key in the Authorization header:
Authorization: Bearer $MATON_API_KEY
Environment Variable: Set your API key as MATON_API_KEY:
export MATON_API_KEY="YOUR_API_KEY"
Getting Your API Key
Sign in or create an account at maton.ai
Go to
Copy your API key
Connection Management Manage your Zoho Calendar OAuth connections at https://ctrl.maton.ai.
List Connections python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=zoho-calendar&status=ACTIVE' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Create Connection python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app' : 'zoho-calendar' }).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections' , data=data, method='POST' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
req.add_header('Content-Type' , 'application/json' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Get Connection python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
{
"connection" : {
"connection_id" : "21fd90f9-5935-43cd-b6c8-bde9d915ca80" ,
"status" : "ACTIVE" ,
"creation_time" : "2025-12-08T07:20:53.488460Z" ,
"last_updated_time" : "2026-01-31T20:03:32.593153Z" ,
"url" : "https://connect.maton.ai/?session_token=..." ,
"app" : "zoho-calendar" ,
"metadata" : { }
}
}
Open the returned url in a browser to complete OAuth authorization.
Delete Connection python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}' , method='DELETE' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Specifying Connection If you have multiple Zoho Calendar connections, specify which one to use with the Maton-Connection header:
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-calendar/api/v1/calendars' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
req.add_header('Maton-Connection' , '21fd90f9-5935-43cd-b6c8-bde9d915ca80' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
If omitted, the gateway uses the default (oldest) active connection.
API Reference
Calendars
List Calendars GET /zoho-calendar/api/v1/calendars
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-calendar/api/v1/calendars' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
{
"calendars" : [
{
"uid" : "fda9b0b4ad834257b622cb3dc3555727" ,
"name" : "My Calendar" ,
"color" : "#8cbf40" ,
"textcolor" : "#FFFFFF" ,
"timezone" : "PST" ,
"isdefault" : true ,
"category" : "own" ,
"privilege" : "owner"
}
]
}
Get Calendar Details GET /zoho-calendar/api/v1/calendars/{calendar_uid}
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-calendar/api/v1/calendars/fda9b0b4ad834257b622cb3dc3555727' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Create Calendar POST /zoho-calendar/api/v1/calendars?calendarData={json}
name - Calendar name (max 50 characters)color - Hex color code (e.g., #FF5733)
textcolor - Text color hex codedescription - Calendar description (max 1000 characters)timezone - Calendar timezoneinclude_infreebusy - Show as Busy/Free (boolean)public - Visibility level (disable, freebusy, or view) python <<'EOF'
import urllib.request, os, json, urllib.parse
calendarData = {
"name" : "Work Calendar" ,
"color" : "#FF5733" ,
"textcolor" : "#FFFFFF" ,
"description" : "My work calendar"
}
url = f'https://gateway.maton.ai/zoho-calendar/api/v1/calendars?calendarData={urllib.parse.quote(json.dumps(calendarData))}'
req = urllib.request.Request(url, method='POST' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
{
"calendars" : [
{
"uid" : "86fb9745076e4672ae4324f05e1f5393" ,
"name" : "Work Calendar" ,
"color" : "#FF5733" ,
"textcolor" : "#FFFFFF"
}
]
}
Delete Calendar DELETE /zoho-calendar/api/v1/calendars/{calendar_uid}
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-calendar/api/v1/calendars/86fb9745076e4672ae4324f05e1f5393' , method='DELETE' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
{
"calendars" : [
{
"uid" : "86fb9745076e4672ae4324f05e1f5393" ,
"calstatus" : "deleted"
}
]
}
Events
List Events GET /zoho-calendar/api/v1/calendars/{calendar_uid}/events?range={json}
Parameter Type Description rangeJSON object Required. Start and end dates in format {"start":"yyyyMMdd","end":"yyyyMMdd"}. Max 31-day span.byinstanceboolean If true, recurring event instances are returned separately timezonestring Timezone for datetime values
python <<'EOF'
import urllib.request, os, json, urllib.parse
from datetime import datetime, timedelta
today = datetime.now()
end_date = today + timedelta(days=7)
range_param = json.dumps({
"start" : today.strftime("%Y%m%d" ),
"end" : end_date.strftime("%Y%m%d" )
})
url = f'https://gateway.maton.ai/zoho-calendar/api/v1/calendars/fda9b0b4ad834257b622cb3dc3555727/events?range={urllib.parse.quote(range_param)}'
req = urllib.request.Request(url)
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
{
"events" : [
{
"uid" : "c63e8b9fcb3e48c2a00b16729932d636@zoho.com" ,
"title" : "Team Meeting" ,
"dateandtime" : {
"timezone" : "America/Los_Angeles" ,
"start" : "20260206T100000-0800" ,
"end" : "20260206T110000-0800"
} ,
"isallday" : false ,
"etag" : "1770368451507" ,
"organizer" : "user@example.com"
}
]
}
Get Event Details GET /zoho-calendar/api/v1/calendars/{calendar_uid}/events/{event_uid}
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-calendar/api/v1/calendars/fda9b0b4ad834257b622cb3dc3555727/events/c63e8b9fcb3e48c2a00b16729932d636@zoho.com' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Create Event POST /zoho-calendar/api/v1/calendars/{calendar_uid}/events?eventdata={json}
Required Fields (in eventdata):
dateandtime - Object with start, end, and optionally timezone
Format: yyyyMMdd'T'HHmmss'Z' (GMT) for timed events
Format: yyyyMMdd for all-day events
title - Event namedescription - Event details (max 10,000 characters)location - Event location (max 255 characters)isallday - Boolean for all-day eventsisprivate - Boolean to hide details from non-delegatescolor - Hex color codeattendees - Array of attendee objectsreminders - Array of reminder objectsrrule - Recurrence rule string (e.g., FREQ=DAILY;COUNT=5) python <<'EOF'
import urllib.request, os, json, urllib.parse
from datetime import datetime, timedelta
start_time = datetime.utcnow() + timedelta(hours=1)
end_time = start_time + timedelta(hours=1)
eventdata = {
"title" : "Team Meeting" ,
"dateandtime" : {
"timezone" : "America/Los_Angeles" ,
"start" : start_time.strftime("%Y%m%dT%H%M%SZ" ),
"end" : end_time.strftime("%Y%m%dT%H%M%SZ" )
},
"description" : "Weekly team sync" ,
"location" : "Conference Room A"
}
url = f'https://gateway.maton.ai/zoho-calendar/api/v1/calendars/fda9b0b4ad834257b622cb3dc3555727/events?eventdata={urllib.parse.quote(json.dumps(eventdata))}'
req = urllib.request.Request(url, method='POST' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
{
"events" : [
{
"uid" : "c63e8b9fcb3e48c2a00b16729932d636@zoho.com" ,
"title" : "Team Meeting" ,
"dateandtime" : {
"timezone" : "America/Los_Angeles" ,
"start" : "20260206T100000-0800" ,
"end" : "20260206T110000-0800"
} ,
"etag" : "1770368451507" ,
"estatus" : "added"
}
]
}
Update Event PUT /zoho-calendar/api/v1/calendars/{calendar_uid}/events/{event_uid}?eventdata={json}
dateandtime - Start and end timesetag - Current etag value (from Get Event Details) Optional Fields: Same as Create Event
python <<'EOF'
import urllib.request, os, json, urllib.parse
from datetime import datetime, timedelta
start_time = datetime.utcnow() + timedelta(hours=2)
end_time = start_time + timedelta(hours=1)
eventdata = {
"title" : "Updated Team Meeting" ,
"dateandtime" : {
"timezone" : "America/Los_Angeles" ,
"start" : start_time.strftime("%Y%m%dT%H%M%SZ" ),
"end" : end_time.strftime("%Y%m%dT%H%M%SZ" )
},
"etag" : 1770368451507
}
url = f'https://gateway.maton.ai/zoho-calendar/api/v1/calendars/fda9b0b4ad834257b622cb3dc3555727/events/c63e8b9fcb3e48c2a00b16729932d636@zoho.com?eventdata={urllib.parse.quote(json.dumps(eventdata))}'
req = urllib.request.Request(url, method='PUT' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Delete Event DELETE /zoho-calendar/api/v1/calendars/{calendar_uid}/events/{event_uid}
etag - Current etag value of the event python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-calendar/api/v1/calendars/fda9b0b4ad834257b622cb3dc3555727/events/c63e8b9fcb3e48c2a00b16729932d636@zoho.com' , method='DELETE' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
req.add_header('etag' , '1770368451507' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
{
"events" : [
{
"uid" : "c63e8b9fcb3e48c2a00b16729932d636@zoho.com" ,
"estatus" : "deleted" ,
"caluid" : "fda9b0b4ad834257b622cb3dc3555727"
}
]
}
Attendees When creating or updating events, include attendees:
{
"attendees" : [
{
"email" : "user@example.com" ,
"permission" : 1 ,
"attendance" : 1
}
]
}
Permission levels: 0 (Guest), 1 (View), 2 (Invite), 3 (Edit)
Attendance: 0 (Non-participant), 1 (Required), 2 (Optional)
Reminders {
"reminders" : [
{
"action" : "popup" ,
"minutes" : 30
} ,
{
"action" : "email" ,
"minutes" : 60
}
]
}
Actions: email, popup, notification
Recurring Events Use the rrule field with iCalendar RRULE format:
{
"rrule" : "FREQ=DAILY;COUNT=5;INTERVAL=1"
}
Daily for 5 days: FREQ=DAILY;COUNT=5;INTERVAL=1
Weekly on Mon/Tue: FREQ=WEEKLY;INTERVAL=1;BYDAY=MO,TU;UNTIL=20250817T064600Z
Monthly last Tuesday: FREQ=MONTHLY;INTERVAL=1;BYDAY=TU;BYSETPOS=-1;COUNT=2
Code Examples
JavaScript const response = await fetch (
'https://gateway.maton.ai/zoho-calendar/api/v1/calendars' ,
{
headers : {
'Authorization' : `Bearer ${process.env.MATON_API_KEY} `
}
}
);
const data = await response.json ();
Python import os
import requests
response = requests.get(
'https://gateway.maton.ai/zoho-calendar/api/v1/calendars' ,
headers={'Authorization' : f'Bearer {os.environ["MATON_API_KEY" ]} ' }
)
data = response.json()
Notes
Event and calendar data is passed as JSON in the eventdata or calendarData query parameter
Date/time format for events: yyyyMMdd'T'HHmmss'Z' (GMT) or yyyyMMdd for all-day events
The range parameter for listing events cannot exceed 31 days
The etag is required for update and delete operations - always get the latest etag before modifying
For delete operations, the etag must be passed as a header, not a query parameter
IMPORTANT: When using curl commands, use curl -g when URLs contain brackets to disable glob parsing
IMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments
Error Handling Status Meaning 400 Missing Zoho Calendar connection, missing required parameter, or invalid request 401 Invalid or missing Maton API key, or OAuth scope mismatch 404 Resource not found 429 Rate limited 4xx/5xx Passthrough error from Zoho Calendar API
Common Errors Error Description ETAG_MISSINGetag header required for delete operations EXTRA_PARAM_FOUNDInvalid parameter in request INVALID_DATAMalformed request data
Troubleshooting: API Key Issues
Check that the MATON_API_KEY environment variable is set:
Verify the API key is valid by listing connections:
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections' )
req.add_header('Authorization' , f'Bearer {os.environ["MATON_API_KEY"]}' )
print (json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
Troubleshooting: Invalid App Name
Ensure your URL path starts with zoho-calendar. For example:
Correct: https://gateway.maton.ai/zoho-calendar/api/v1/calendars
Incorrect: https://gateway.maton.ai/api/v1/calendars
Resources 