Call Operations
Access call recordings, transcriptions, and metadata from phone conversations. Download transcripts for training, compliance, or AI-powered analysis.
Phone calls generate some of the richest data in your CRM, but that data is only useful if you can access it programmatically. Call Operations gives you access to recordings, transcriptions, and metadata from phone conversations. This powers use cases like AI-driven call analysis, compliance archiving, team coaching, and automated post-call follow-up based on what was actually said on the call.
What This MCP Tool Does
Retrieve call recordings, access call transcriptions, and download transcript files from phone conversations. Combined with other MCP tools, you can build automated pipelines that listen to what happened on a call and take action — log a summary to Contact Notes, create a follow-up Task, or trigger a Workflow based on call outcomes.
Endpoint Reference
Get call recording:
GET /messages/{messageId}/recording
Retrieve the audio recording of a phone call. Returns a URL to the recording file.
Get call transcription:
GET /messages/{messageId}/transcription
Access the text transcription of a phone call.
Download transcription:
GET /messages/{messageId}/transcription/download
Download the transcription as a file for external processing or archiving.
Authentication
Requires a Private Integration Token (PIT) with the conversations scope enabled. Call recording must be enabled on the location for recordings to exist.
Key Parameters
messageId— the message ID of the phone call (calls are messages in GHL’s conversation system)
Important Notes
Call recordings only exist if recording is enabled on the location’s phone configuration. If recording is off, the recording endpoint returns nothing for that call.
Transcriptions are generated by GHL’s transcription service. Quality depends on audio clarity, background noise, and accent. Machine transcription is not perfect — treat it as a useful summary, not a legal record.
Call metadata (duration, direction, timestamps) is available through the message record itself via Message Manager. The endpoints here specifically handle the audio and text artifacts.
Recording storage and access may be subject to retention policies depending on your GHL plan level.
Be aware of call recording consent laws. Many states require two-party consent for call recording. GHL provides the recording capability, but compliance with local recording laws is your responsibility.
Common Questions
Can I use call transcripts for AI analysis? Yes. Download the transcript, pass it to an AI model for sentiment analysis, objection detection, coaching opportunities, or summary generation, then log the results back to the contact via Contact Notes.
Are all calls automatically transcribed? Transcription availability depends on your GHL plan and configuration. Not all plans include automatic transcription.
How long are recordings stored? Storage duration depends on your GHL plan. Check your plan’s recording retention policy.
Can I download recordings programmatically? Yes. The recording endpoint returns a URL to the audio file that you can download and store in your own systems.
Can I trigger actions based on call content? Not natively through MCP alone. But you can build a pipeline: call occurs, retrieve transcript via MCP, analyze with AI, then use MCP to create tasks, add tags, or enroll in workflows based on the analysis.
Related MCP Tools
- Contact Notes — Log call summaries to the contact record
- Contact Tasks — Create follow-up tasks after call analysis
- Campaign & Workflow — Trigger post-call workflows
- Message Manager — Access call metadata and status
- Conversation CRUD — Find the conversation containing the call