# List Events — Zoho Calendar

> Returns a list of all the events in a particular calendar of the user. See the documentation

- Key: `zoho_calendar-list-events`
- Type: Action (Read-only)
- Version: 0.0.3
- App: Zoho Calendar (`zoho_calendar`) — https://pipedream.com/apps/zoho-calendar.md
- This page (HTML): https://pipedream.com/apps/zoho-calendar/actions/list-events
- Hints: read-only · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/zoho_calendar/actions/list-events/list-events.mjs

## Description

Returns a list of all the events in a particular calendar of the user. [See the documentation](https://www.zoho.com/calendar/help/api/get-events-list.html)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `calendarId` | `string` | Yes | The id of the calendar Options are loaded from the connected account. |
| `startDate` | `string` | No | 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. |
| `endDate` | `string` | No | 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. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_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",
  },
})
```

**TypeScript**

```ts
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**

```bash
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"
    }
  }'
```

---

- App: https://pipedream.com/apps/zoho-calendar.md · All apps: https://pipedream.com/apps