# Gong — MCP server on mcp.ai
> Gong is a platform for video meetings, call recording, and team collaboration.

By: mcp.ai · official
Page: https://mcp.ai/gong

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_gong?ms=1781542800000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/gong/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/gong/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/gong/skill.md
Postman collection (v2.1): https://mcp.ai/gong/postman.json

## Tools
- gong_add_call_media_v2_calls_id_media(id: string, mediaFile?: object) — Adds a call media, recorded by a telephony system (pbx) or other media recording facility. gong accepts call recordings in various audio and video file formats, including wav, mp3, mp4, mkv and flac. 
- gong_add_new_call_v2_calls(title?: string, context?: object[], parties: object[], purpose?: string, duration?: integer, direction: string, customData?: string, meetingUrl?: string, actualStart: string, disposition?: string, primaryUser: string, workspaceId?: string, languageCode?: string, scheduledEnd?: string, clientUniqueId: string, scheduledStart?: string, callProviderCode?: string, downloadMediaUrl?: string, speakersTimeline__precise?: boolean, speakersTimeline__speechSegments?: object[]) — When using this endpoint, either provide a downloadmediaurl or use the returned callid in a follow-up request to /v2/calls/{id}/media to upload the media file. when accessed through a bearer token aut
- gong_aggregate_activity_by_period_via_api(cursor?: string, filter__toDate?: string, filter__userIds?: string[], filter__fromDate?: string, aggregationPeriod: string, filter__createdToDateTime?: string, filter__createdFromDateTime?: string) — Lists the aggregated activity of multiple users within the gong system for each time period within the defined date range. this endpoint returns multiple records, one for each user. for each user ther
- gong_aggregate_user_activity_statistics(cursor?: string, filter__toDate?: string, filter__userIds?: string[], filter__fromDate?: string, filter__createdToDateTime?: string, filter__createdFromDateTime?: string) — Lists the activity of multiple users within the gong system during a defined period. given the period, this endpoint returns multiple records, one for each user, with an applicable activity during the
- gong_assign_prospects_to_flow(flowId: string, crmProspectsIds: string[], flowInstanceOwnerEmail: string) — Use this endpoint to assign a number of prospects to a flow. prospects can be contacts or leads in your crm. generate a list of comma separated crm ids of the prospects you want to add to a flow. the 
- gong_create_a_new_gong_meeting_v2_meetings(title?: string, endTime: string, invitees: object[], startTime: string, externalId?: string, organizerEmail: string) — When accessed through a bearer token authorization method, this endpoint requires the scope 'api:meetings:user:create'.
- gong_create_activity_scorecards_report(cursor?: string, filter__callToDate?: string, filter__callFromDate?: string, filter__reviewMethod?: string, filter__reviewToDate?: string, filter__scorecardIds?: string[], filter__reviewFromDate?: string, filter__reviewedUserIds?: string[]) — Retrieve all the answers for the scorecards that were reviewed during a specified date range, for calls that took place during a specified date range, for specific scorecards or for specific reviewed 
- gong_create_permission_profile_v2_permission_profile(id?: string, name?: string, deals?: boolean, usage?: boolean, market?: boolean, account?: boolean, library?: boolean, activity?: boolean, coaching?: boolean, forecast?: boolean, teamStats?: boolean, trimCalls?: boolean, scoreCalls?: boolean, deleteCalls?: boolean, description?: string, initiatives?: boolean, workspaceId: string, deleteEmails?: boolean, privateCalls?: boolean, crmDataImport?: boolean, listenInCalls?: boolean, overrideScore?: boolean, callsAndSearch?: boolean, forecastManage?: boolean, manageScorecards?: boolean, downloadCallMedia?: boolean, dealsInlineEditing?: boolean, crmDataInlineEditing?: boolean, viewRevenueAnalytics?: boolean, manageRevenueAnalytics?: boolean, shareCallsWithCustomers?: boolean, callsAccess__teamLeadIds?: string[], dealsAccess__teamLeadIds?: string[], usageAccess__teamLeadIds?: string[], viewEngageAnalyticsFlows?: boolean, emailsAccess__teamLeadIds?: string[], coachingAccess__teamLeadIds?: string[], insightsAccess__teamLeadIds?: string[], viewEngageAnalyticsActivity?: boolean, callsAccess__permissionLevel?: string, dealsAccess__permissionLevel?: string, engageManageCompanySequences?: boolean, engageManageCompanyTemplates?: boolean, usageAccess__permissionLevel?: string, emailsAccess__permissionLevel?: string, engageCreateAndManageRulesets?: boolean, manageGeneralBusinessSettings?: boolean, createEditAndDeleteDealsBoards?: boolean, engageSnoozeFlowToDosForOthers?: boolean, manuallyScheduleAndUploadCalls?: boolean, viewEngageAnalyticsPerformance?: boolean, coachingAccess__permissionLevel?: string, exportCallsAndCoachingDataToCSV?: boolean, insightsAccess__permissionLevel?: string, libraryFolderAccess__manageStreams?: boolean, libraryFolderAccess__permissionLevel?: string, libraryFolderAccess__libraryFolderIds?: string[], libraryFolderAccess__manageFolderCalls?: boolean, libraryFolderAccess__managePublicFolder?: boolean, libraryFolderAccess__shareFoldersAndStreams?: boolean, forecastPermissions__forecastAccess__teamLeadIds?: string[], forecastPermissions__forecastAccess__permissionLevel?: string, forecastPermissions__forecastEditTargets__teamLeadIds?: string[], forecastPermissions__forecastEditSubmissions__teamLeadIds?: string[], forecastPermissions__forecastEditTargets__permissionLevel?: string, forecastPermissions__forecastEditSubmissions__permissionLevel?: string) — Create a permission profile in a given workspace.
- gong_data_privacy_for_phone_number(phoneNumber: string) — Shows the elements in the gong system that reference the given phone number. given a phone number, this endpoint returns details of any leads or contacts with this phone number and their associated ca
- gong_delete_a_generic_crm_integration_v2_crm_integrations(integrationId: integer, clientRequestId: string) — Deletes an existing crm integration from the gong platform. this endpoint should be used when you want to disconnect or remove a previously established integration between gong and a crm system, such 
- gong_delete_a_gong_meeting_v2_meetings(meetingId: integer, organizerEmail?: string) — When accessed through a bearer token authorization method, this endpoint requires the scope 'api:meetings:user:delete'.
- gong_delete_users_from_call_access_list(callAccessList?: object[]) — Remove individual user access from calls. the request can only remove access previously given by the /v2/calls/users-access api. if a given user does not have access to the call, they will be unaffect
- gong_erase_data_for_email_address(emailAddress: string) — Given an email address, this endpoint deletes from the gong system any calls or email messages that reference this address. email messages sent to or from the address are deleted. calls where the emai
- gong_erase_data_for_phone_number(phoneNumber: string) — Given a phone number, this endpoint deletes from the gong system any leads or contacts with a matching phone number or mobile phone number. email messages sent to or from these leads/contacts are dele
- gong_fetch_all_permission_profiles(workspaceId: string) — Returns a list of all permission profiles. the listing is in the alphabetical order of the profile names.
- gong_get_crm_integration_details() — <style>.public-api-info { background: rgb(222, 235, 255);}.public-api-tip { background: rgb(227, 252, 239);}.public-api-parameter { background: rgba(9,30,66,0.08);}.public-api-note { background: rgb(2
- gong_get_crm_objects_v2_crm_entities(objectType: string, integrationId: integer, objectsCrmIds: string[]) — Retrieves crm entities from the gong platform. this endpoint allows users to fetch various crm objects such as accounts, deals, and contacts that have been integrated with gong's revenue intelligence 
- gong_get_permission_profile(profileId: string) — Returns a permission profile.
- gong_get_request_status_v2_crm_request_status(integrationId: integer, clientRequestId: string) — The getcrmrequeststatus endpoint retrieves the current status of crm integration requests in the gong platform. it allows users to check the progress and outcome of operations related to crm data uplo
- gong_list_all_coaching_metrics_v2_coaching(to: string, from: string, manager__id: integer, workspace__id: integer) — List all of the coaching metrics of a manager. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:coaching:read'.
- gong_list_all_company_workspaces_v2_workspaces() — Returns a list of all workspaces including their details. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:workspaces:read'.
- gong_list_all_users_v2_users(cursor?: string, includeAvatars?: boolean) — List all of the company's users. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:users:read'.
- gong_list_flows_for_crm_prospects(crmProspectsIds: string[]) — Get the gong engage flows assigned to the given prospects. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:flows:read'.
- gong_list_folder_calls(folderId?: string) — Given a folder id, this endpoint retrieves a list of calls in it. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:library:read'.
- gong_list_gong_engage_flows_v2_flows(cursor?: string, workspaceId?: string, flowOwnerEmail: string) — Engage flows have the following visibility types: * company: visible to everyone in the company, can only be edited by users with edit permissions. * personal: reps can set up their own flows which ar
- gong_list_schema_fields_v2_crm_entity_schema(objectType: string, integrationId: integer) — Retrieves the comprehensive schema of crm entities in the gong platform. this endpoint provides detailed metadata about the structure, attributes, and relationships of entities within the customer rel
- gong_list_users_by_filter_v2_users_extensive(cursor?: string, filter__userIds?: string[], filter__includeAvatars?: boolean, filter__createdToDateTime?: string, filter__createdFromDateTime?: string) — List multiple users. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:users:read'.
- gong_manage_user_call_access(filter__callIds?: string[]) — Returns a list of users who have received individual access to calls through the api. this endpoint doesn't cover user that have access for other reasons (such as sharing recipients, or access through
- gong_post_a_digital_interaction_v2_digital_interaction(device?: string, eventId: string, eventType: string, sessionId?: string, timestamp: string, trackingId?: string, customFields?: object[], person__name?: string, person__email?: string, person__personId?: string, sourceSystemName?: string, content__contentId?: string, content__contentUrl?: string, person__phoneNumber?: string, content__contentLabel?: string[], content__contentTitle?: string, person__company__name?: string, person__location__city?: string, person__company__domain?: string, person__location__state?: string, person__location__region?: string, person__location__country?: string, person__company__companyId?: string, person__personCustomFields?: object[], content__contentCustomFields?: object[], content__contentAdditionalInfoUrl?: string, content__searchObjectDetails__url?: string, content__searchObjectDetails__name?: string, content__stepContentDetails__value?: string, content__searchObjectDetails__domain?: string, content__numericContentDetails__value?: integer, content__searchObjectDetails__objectId?: string, content__numericContentDetails__rangeTo?: integer, person__personBusinessContext__objectId?: string, content__searchObjectDetails__objectType?: string, person__company__companyBusinessContexts?: object[], content__numericContentDetails__rangeFrom?: integer, person__personBusinessContext__objectType?: string, person__personBusinessContext__systemName?: string, content__numericContentDetails__numericType?: string, content__stepContentDetails__availableSteps?: string[]) — When accessed through a bearer token authorization method, this endpoint requires the scope 'api:digital-interactions:write'.
- gong_post_day_by_day_activity_stats(cursor?: string, filter__toDate?: string, filter__userIds?: string[], filter__fromDate?: string, filter__createdToDateTime?: string, filter__createdFromDateTime?: string) — Retrieve the daily activity of multiple users within the gong system for a range of dates. this endpoint returns records including statistics about each user's activity, on the daily level. records ar
- gong_post_interaction_filter_stats(cursor?: string, filter__toDate?: string, filter__userIds?: string[], filter__fromDate?: string, filter__createdToDateTime?: string, filter__createdFromDateTime?: string) — Returns interaction stats for users based on calls that have whisper turned on. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:stats:interaction'.
- gong_post_meeting_integration_status(emails?: string[]) — When accessed through a bearer token authorization method, this endpoint requires the scope 'api:meetings:integration:status'.
- gong_register_crm_integration(name: string, ownerEmail: string) — Updates an existing crm integration in the gong platform. this endpoint allows you to modify the details of a previously set up integration between gong and your customer relationship management (crm)
- gong_report_content_viewed_event(eventId?: string, shareId?: string, contentId: string, userAgent?: string, actionName?: string, contentUrl: string, crmContext?: object[], sharer__id?: string, trackingId?: string, mobileAppId?: string, moreInfoUrl?: string, viewInfoUrl?: string, workspaceId?: string, contentTitle: string, sharer__name?: string, viewer__name?: string, agentPlatform?: string, sharer__email?: string, viewer__email?: string, viewer__title?: string, eventTimestamp: string, eventProperties?: object[], reportingSystem: string, viewActionTitle?: string, viewer__context?: object[], contentProperties?: object[], sharingMessageBody?: string, sharingMessageSubject?: string, nonCompanyParticipants?: object[]) — Push engagement events into gong and display them as events in gong’s activity timeline, when a content is viewed by an external participant (for example, a contract was “viewed” by the prospect) when
- gong_report_custom_engagement_event(eventId?: string, shareId?: string, contentId?: string, userAgent?: string, actionName?: string, contentUrl?: string, crmContext?: object[], sharer__id?: string, trackingId?: string, actor__name?: string, mobileAppId?: string, moreInfoUrl?: string, workspaceId?: string, actor__email?: string, actor__title?: string, contentTitle?: string, eventInfoUrl?: string, sharer__name?: string, agentPlatform?: string, sharer__email?: string, actor__context?: object[], eventTimestamp: string, eventProperties?: object[], reportingSystem: string, contentProperties?: object[], sharingMessageBody?: string, sharingMessageSubject?: string, nonCompanyParticipants?: object[]) — Push engagement events into gong and display them as events in gong’s activity timeline, when a content is engaged by an external participant (for example, a contract was “signed” by the prospect) whe
- gong_retrieve_call_data_by_date_range_v2_calls(cursor?: string, toDateTime: string, workspaceId?: string, fromDateTime: string) — List calls that took place during a specified date range. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:calls:read:basic'.
- gong_retrieve_data_for_a_specific_call_v2_calls_id(id: string) — Retrieve data for a specific call. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:calls:read:basic'.
- gong_retrieve_data_privacy_info_for_email_address(emailAddress: string) — Shows the elements in the gong system that reference the given email address. given an emails address, this endpoint returns details of all calls and email messages that reference this address, and an
- gong_retrieve_filtered_call_details(cursor?: string, filter__callIds?: string[], filter__toDateTime?: string, filter__workspaceId?: string, filter__fromDateTime?: string, filter__primaryUserIds?: string[], contentSelector__context?: string, contentSelector__contextTiming?: string[], contentSelector__exposedFields__media?: boolean, contentSelector__exposedFields__parties?: boolean, contentSelector__exposedFields__content__brief?: boolean, contentSelector__exposedFields__content__topics?: boolean, contentSelector__exposedFields__content__outline?: boolean, contentSelector__exposedFields__content__trackers?: boolean, contentSelector__exposedFields__content__keyPoints?: boolean, contentSelector__exposedFields__content__structure?: boolean, contentSelector__exposedFields__interaction__video?: boolean, contentSelector__exposedFields__content__highlights?: boolean, contentSelector__exposedFields__content__callOutcome?: boolean, contentSelector__exposedFields__interaction__speakers?: boolean, contentSelector__exposedFields__interaction__questions?: boolean, contentSelector__exposedFields__content__pointsOfInterest?: boolean, contentSelector__exposedFields__content__trackerOccurrences?: boolean, contentSelector__exposedFields__collaboration__publicComments?: boolean, contentSelector__exposedFields__interaction__personInteractionStats?: boolean) — Lists detailed call data for calls that took place during a specified date range, have specified call ids or hosted by specified users. when accessed through a bearer token authorization method, this 
- gong_retrieve_library_folders_v2_library_folders(workspaceId?: string) — Use this endpoint to retrieve a list of public library folders. we do not allow retrieval of either private or archived folders. when accessed through a bearer token authorization method, this endpoin
- gong_retrieve_logs_data_by_type_and_time_range_v2_logs(cursor?: string, logType: string, toDateTime?: string, fromDateTime: string) — List log entries that took place during a specified time range. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:logs:read'.
- gong_retrieve_manual_crm_call_associations(cursor?: string, fromDateTime?: string) — Returns a list of all calls that were manually associated or re-associated with crm account and deal/opportunity since a given time. actions will be listed in the ascending order of their timing. noti
- gong_retrieve_scorecards_details_v2_settings_scorecards() — Retrieve all the scorecards within the gong system. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:settings:scorecards:read'.
- gong_retrieve_tracker_details_v2_settings_trackers(workspaceId?: string) — Retrieves details of all keyword trackers in the system or in a given workspace. when accessed through a bearer token authorization method, this endpoint requires the 'api:settings:trackers:read' scop
- gong_retrieve_transcripts_of_calls_v2_calls_transcript(cursor?: string, filter__callIds?: string[], filter__toDateTime?: string, filter__workspaceId?: string, filter__fromDateTime?: string) — Returns transcripts for calls that took place during the specified date period. if call ids are specified, only transcripts for calls with those ids that took place during the time period are returned
- gong_retrieve_user_settings_history(id: string) — Retrieve a specific user's settings history. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:users:read'.
- gong_retrieve_user_v2_users_id(id: string) — Retrieve a specific user. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:users:read'.
- gong_retrieve_users_from_permission_profile(profileId: string) — Returns a list of all users whose access is controlled by the given permission profile. when accessed through a bearer token authorization method, this endpoint requires the scope 'api:users:read'.
- gong_set_user_call_access(callAccessList?: object[]) — Give individual users access to calls. if a user already has access (perhaps the call was shared with them, or they have access through their permission profiles) the request will have no effect. when
- gong_update_a_gong_meeting_v2_meetings_meeting_id(title?: string, endTime: string, invitees: object[], meetingId: integer, startTime: string, externalId?: string, organizerEmail: string) — When accessed through a bearer token authorization method, this endpoint requires the scope 'api:meetings:user:update'.
- gong_update_permission_profile_v2_permission_profile(id?: string, name?: string, deals?: boolean, usage?: boolean, market?: boolean, account?: boolean, library?: boolean, activity?: boolean, coaching?: boolean, forecast?: boolean, profileId: string, teamStats?: boolean, trimCalls?: boolean, scoreCalls?: boolean, deleteCalls?: boolean, description?: string, initiatives?: boolean, deleteEmails?: boolean, privateCalls?: boolean, crmDataImport?: boolean, listenInCalls?: boolean, overrideScore?: boolean, callsAndSearch?: boolean, forecastManage?: boolean, manageScorecards?: boolean, downloadCallMedia?: boolean, dealsInlineEditing?: boolean, crmDataInlineEditing?: boolean, viewRevenueAnalytics?: boolean, manageRevenueAnalytics?: boolean, shareCallsWithCustomers?: boolean, callsAccess__teamLeadIds?: string[], dealsAccess__teamLeadIds?: string[], usageAccess__teamLeadIds?: string[], viewEngageAnalyticsFlows?: boolean, emailsAccess__teamLeadIds?: string[], coachingAccess__teamLeadIds?: string[], insightsAccess__teamLeadIds?: string[], viewEngageAnalyticsActivity?: boolean, callsAccess__permissionLevel?: string, dealsAccess__permissionLevel?: string, engageManageCompanySequences?: boolean, engageManageCompanyTemplates?: boolean, usageAccess__permissionLevel?: string, emailsAccess__permissionLevel?: string, engageCreateAndManageRulesets?: boolean, manageGeneralBusinessSettings?: boolean, createEditAndDeleteDealsBoards?: boolean, engageSnoozeFlowToDosForOthers?: boolean, manuallyScheduleAndUploadCalls?: boolean, viewEngageAnalyticsPerformance?: boolean, coachingAccess__permissionLevel?: string, exportCallsAndCoachingDataToCSV?: boolean, insightsAccess__permissionLevel?: string, libraryFolderAccess__manageStreams?: boolean, libraryFolderAccess__permissionLevel?: string, libraryFolderAccess__libraryFolderIds?: string[], libraryFolderAccess__manageFolderCalls?: boolean, libraryFolderAccess__managePublicFolder?: boolean, libraryFolderAccess__shareFoldersAndStreams?: boolean, forecastPermissions__forecastAccess__teamLeadIds?: string[], forecastPermissions__forecastAccess__permissionLevel?: string, forecastPermissions__forecastEditTargets__teamLeadIds?: string[], forecastPermissions__forecastEditSubmissions__teamLeadIds?: string[], forecastPermissions__forecastEditTargets__permissionLevel?: string, forecastPermissions__forecastEditSubmissions__permissionLevel?: string) — Update a permission profile.
- gong_update_shared_content_event(eventId?: string, shareId?: string, contentId: string, userAgent?: string, actionName?: string, contentUrl: string, crmContext?: object[], recipients?: object[], sharer__id?: string, trackingId?: string, mobileAppId?: string, moreInfoUrl?: string, workspaceId?: string, contentTitle: string, shareInfoUrl?: string, sharer__name?: string, agentPlatform?: string, sharer__email?: string, eventTimestamp: string, eventProperties?: object[], reportingSystem: string, contentProperties?: object[], sharingMessageBody?: string, sharingMessageSubject?: string, nonCompanyParticipants?: object[]) — Push engagement events into gong and display them as events in gong’s activity timeline, when a gong user shares content with external participants (for example, a contract was “shared” by the account
- gong_upload_crm_objects_v2_crm_entities(dataFile?: object) — Uploads crm data files to the gong platform for integration and analysis. this endpoint allows users to send large crm data files (up to 200mb) using a multipart/form-data request. it should be used w

## Links
Docs: https://mcp.ai/docs/mcps/gong
Website: https://mcp.ai/mcps/gong