Read AI ACTION
List Meetings
Retrieves a paginated list of meetings from Read AI, ordered by most recent first. Use this to browse meeting history or to find a specific meeting before calling Get Meeting for full details. Supports date range filtering via Unix millisecond timestamps. Returns meeting metadata including ID, title, participants, platform (Zoom/Teams/Google Meet), start time, and duration. Use the expand options to include richer content (summary, action items, transcript, etc.) directly in the listing — note that active meetings will have limited or no data for expanded fields, as these are generated after a meeting concludes. When
has_more is true in the response, pass the id of the last meeting in the data array to the cursor parameter to retrieve the next page. To convert a human date to Unix ms, multiply Unix seconds by 1000 (e.g. 7 days ago = Date.now() - 7*24*60*60*1000). See the documentation- Action
- Read only
- OAuth
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Read AI account once, then configure and run List Meetings 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: "read_ai-list-meetings",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
read_ai: { authProvisionId: "apn_xxxxxxx" },
startTimeMs: 10,
endTimeMs: 10,
},
})
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": "read_ai-list-meetings",
"configured_props": {
"read_ai": { "authProvisionId": "apn_xxxxxxx" },
"startTimeMs": 10,
"endTimeMs": 10
}
}'// 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": "read_ai",
},
},
},
)
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: "read_ai-list-meetings",
arguments: {
startTimeMs: 10,
endTimeMs: 10,
},
})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 |
|---|---|---|
startTimeMs Start Time (ms) | integer | Filter meetings that started at or after this Unix timestamp in milliseconds. Example: 1700000000000 for a fixed date, or compute relative times like 7 days ago. Optional |
endTimeMs End Time (ms) | integer | Filter meetings that started at or before this Unix timestamp in milliseconds. Example: 1700000000000. Optional |
limit Limit | integer | Number of meetings to return. Maximum is 10. Required |
cursor Pagination Cursor | string | Cursor from a previous list response ( nextCursor) to retrieve the next page of results. Optional |
includeSummary Include Summary | boolean | Include the AI-generated meeting summary and chapter summaries. Optional |
includeActionItems Include Action Items | boolean | Include extracted action items with implied owners. Optional |
includeTranscript Include Transcript | boolean | Include the full word-for-word transcript with speaker attribution. Can be very large for long meetings. Optional |
includeKeyQuestions Include Key Questions | boolean | Include key questions flagged by AI during the meeting. Optional |
includeTopics Include Topics | boolean | Include identified discussion topics and subject areas. Optional |
includeMetrics Include Metrics | boolean | Include speaker engagement metrics: talk time, interruptions, engagement scores. Optional |
includeRecordingDownload Include Recording Download URL | boolean | Include a presigned URL to download the meeting recording. 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
- read_ai-list-meetings
- Version
- 0.1.1
- App
- Read AI
- Authentication
- OAuth
- Read-only
- Yes
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗