Gong ACTION
Search Calls
Search calls and return their metadata together with whichever detail sections you ask for: the AI call brief (summary), key points, outline (which contains the next steps), highlights, call outcome, topics, keyword tracker hits, participants, interaction stats, and linked CRM records such as the account and deal. This is the tool for questions like "what happened on last quarter's calls", "what were the next steps", or "which deals do these calls belong to". Brief, key points, outline, highlights, and call outcome come from Gong's Spotlight AI. They are silently omitted for calls Gong has not generated them for (very short calls, calls without a transcript, or workspaces without the feature). See the documentation
- Action
- Read only
- OAuth
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Gong account once, then configure and run Search Calls 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: "gong-get-extensive-data",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
gong: { authProvisionId: "apn_xxxxxxx" },
fromDateTime: "From Date Time",
toDateTime: "To Date Time",
},
})
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": "gong-get-extensive-data",
"configured_props": {
"gong": { "authProvisionId": "apn_xxxxxxx" },
"fromDateTime": "From Date Time",
"toDateTime": "To Date Time"
}
}'// 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": "gong",
},
},
},
)
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: "gong-get-extensive-data",
arguments: {
fromDateTime: "From Date Time",
toDateTime: "To Date Time",
},
})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 |
|---|---|---|
fromDateTime From Date Time | string | Only return calls that started on or after this date and time, in ISO-8601 format (e.g. 2026-01-01T00:00:00Z). Omit to start from the earliest call. Optional |
toDateTime To Date Time | string | Only return calls that started before this date and time, in ISO-8601 format (e.g. 2026-04-01T00:00:00Z). The bound is exclusive. Omit to end at the most recent call. Optional |
workspaceId Workspace ID | string | Return only calls belonging to this workspace. Cannot be combined with Call IDs. Use the List Workspace ID Options action to discover workspace IDs. Optional Dynamic |
callIds Call IDs | string[] | Return only these calls. Pass a single ID to fetch one call. Cannot be combined with Workspace ID. Use List Calls to discover call IDs. Optional Dynamic |
primaryUserIds Primary User IDs | string[] | Return only calls hosted by these Gong users, matched against each call's primaryUserId. This is how you find a given rep's calls. Use the List Users action to discover user IDs. Optional Dynamic |
content Content | string[] | Which call-content sections to return. Defaults to the insight fields (brief, key points, outline, highlights, call outcome, topics). Select Tracker Occurrences only together with Trackers. Optional |
interaction Interaction Stats | string[] | Which interaction statistics to return, such as per-speaker talk time and talk ratio. Omit for none. Optional |
includeParties Include Parties | boolean | Whether to return the call's participants (name, email, affiliation as Internal or External, speakerId, and any linked CRM contact). Needed to attribute transcript speakers to people. Optional |
context CRM Context | string | How much external-system (CRM, telephony, case management) data to attach to each call and party. Set to Extended to get account and deal field values. Optional |
contextTiming Context Timing | string[] | Whether CRM values should reflect their state now, at the time of the call, or both. Only valid when CRM Context is Extended. Defaults to Now. Optional |
includePublicComments Include Public Comments | boolean | Whether to return public comments left on the call in Gong. Optional |
includeMedia Include Media URLs | boolean | Whether to return audio and video download URLs. Requires the api:calls:read:media-url scope; the URLs are short-lived. Optional |
limit Limit | integer | Maximum number of calls to return. Min 1, max 1000. 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
- gong-get-extensive-data
- Version
- 1.0.0
- App
- Gong
- Authentication
- OAuth
- Read-only
- Yes
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗