Zoho Calendar ACTION
List Events
Returns a list of all the events in a particular calendar of the user. See the documentation
- Action
- Read only
- OAuth
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Zoho Calendar account once, then configure and run List Events from your backend or agent.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "zoho_calendar-list-events",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
zoho_calendar: { authProvisionId: "apn_xxxxxxx" },
calendarId: "Calendar ID",
startDate: "Start Date",
},
})
console.log(result)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "zoho_calendar-list-events",
"configured_props": {
"zoho_calendar": { "authProvisionId": "apn_xxxxxxx" },
"calendarId": "Calendar ID",
"startDate": "Start Date"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "zoho_calendar",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "zoho_calendar-list-events",
arguments: {
calendarId: "Calendar ID",
startDate: "Start Date",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
calendarId Calendar ID | string | The id of the calendar Required Dynamic |
startDate Start Date | string | When the Start Date parameter is passed, the events which occur between the given start and end dates are retrieved. It should contain the start and end parameters in UNIX date time format e.g. yyyyMMddTHHmmssZ or yyyyMMdd The range period cannot exceed 31 days. Optional |
endDate End Date | string | When the End Date parameter is passed, the events which occur between the given start and end dates are retrieved. It should contain the start and end parameters in UNIX date time format e.g. yyyyMMddTHHmmssZ or yyyyMMdd The range period cannot exceed 31 days. Optional |
REFERENCE
Tool details
Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.
- Registry key
- zoho_calendar-list-events
- Version
- 0.0.3
- App
- Zoho Calendar
- Authentication
- OAuth
- Read-only
- Yes
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗