> This page is for version v8.3.0 (default). > For other versions, use one of these documentation indexes: > - v8.3.0 (default): https://docs.workflows.com/v-8-3-0/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.workflows.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.workflows.com/_mcp/server. # fathom_get_transcript READ # fathom_get_transcript Retrieves the complete transcript of a Fathom meeting with full speaker attribution. This is the primary tool for extracting meeting conversation data to create minds or analyze discussions. > **Success** > > Fathom transcripts include accurate speaker attribution with both names and email addresses, making them ideal for creating minds and analyzing individual communication patterns. ## Prerequisites > **Fathom Integration Required** > > This tool requires Fathom integration to be configured. See the [Fathom Setup Guide](/mcp-integrations-fathom-setup) for configuration instructions. ## Parameters ### meetingId
**Type** string
**Required** Yes
**Description** The unique meeting identifier from `fathom_list_meetings` response
**Example** `meeting_abc123`
## Request ```json { "meetingId": "meeting_abc123" } ``` ## Response ```json { "meetingId": "meeting_abc123", "title": "Product Planning - Q4 Roadmap", "date": "2024-11-15T14:00:00Z", "duration": 3600, "transcript": [ { "speakerName": "Sarah Chen", "speakerEmail": "sarah.chen@company.com", "text": "Thanks everyone for joining. Let's review our Q4 priorities and make some key decisions on the roadmap.", "timestamp": "00:00:12" }, { "speakerName": "Mike Johnson", "speakerEmail": "mike.johnson@company.com", "text": "I think we should focus on enterprise features. Our largest customers are asking for advanced permissions and SSO integration.", "timestamp": "00:00:28" }, { "speakerName": "Alex Rivera", "speakerEmail": "alex.rivera@company.com", "text": "Agreed. The API improvements are also critical. We're seeing a lot of integration requests from our developer community.", "timestamp": "00:00:45" } ] } ``` ### Response Properties | Property | Type | Description | | --------------------------- | ------ | --------------------------------------------------- | | `meetingId` | string | The meeting identifier | | `title` | string | Meeting title from calendar | | `date` | string | ISO 8601 timestamp of the meeting | | `duration` | number | Meeting duration in seconds | | `transcript` | array | Array of transcript segments in chronological order | | `transcript[].speakerName` | string | Full name of the speaker | | `transcript[].speakerEmail` | string | Email address of the speaker | | `transcript[].text` | string | The spoken text for this segment | | `transcript[].timestamp` | string | Timestamp within the meeting (HH:MM:SS format) | ## Common Use Cases #### Create Minds from Team Meetings Extract conversation data to train digital minds on team member communication styles. **Example:** ``` "Get the transcript from my sprint planning meeting and create minds for each engineer based on their input" ``` **Natural language workflow:** 1. AI uses `fathom_list_meetings` to find sprint planning meeting 2. Uses `fathom_get_transcript` to retrieve full conversation 3. Identifies unique engineers from speaker emails 4. Creates mind for each engineer 5. Uploads their transcript segments as training data **What you get:** * Minds trained on actual communication patterns * Ability to simulate future discussions * Insights into decision-making and problem-solving styles #### Analyze Client Conversations Extract client feedback and communication patterns from meeting transcripts. **Example:** ``` "Get transcripts from all my client meetings this month and create a mind for our main stakeholder" ``` **Natural language workflow:** * Lists client meetings * Retrieves transcripts for all * Combines stakeholder's segments across meetings * Creates consolidated mind **What you get:** * Client communication style insights * Pattern recognition across meetings * Ability to simulate client responses * Better stakeholder understanding #### Training and Knowledge Transfer Use real meeting transcripts for team training and onboarding. **Example:** ``` "Get transcripts from my top 5 successful sales calls and extract the discovery question patterns" ``` **Natural language workflow:** * Identifies top performing calls * Retrieves transcripts * Analyzes question patterns * Extracts effective techniques **What you get:** * Real-world conversation examples * Proven communication techniques * Training materials from actual meetings * Best practice documentation ## Error Responses #### 404 Not Found ```json { "error": "Not Found", "message": "Meeting with ID 'meeting_abc123' does not exist" } ``` **Solution:** Verify the meeting ID is correct. Use `fathom_list_meetings` to get valid meeting IDs. #### 401 Unauthorized ```json { "error": "Unauthorized", "message": "Fathom authentication failed" } ``` **Solution:** Verify your Fathom API key is configured correctly. #### 403 Forbidden ```json { "error": "Forbidden", "message": "You do not have permission to access this meeting" } ``` **Solution:** Check your Fathom permissions for this meeting. #### 400 Transcript Not Available ```json { "error": "Bad Request", "message": "Transcript not yet available for this meeting" } ``` **Solution:** Meeting may still be processing. Wait and retry. Check status in Fathom. ## Best Practices #### Speaker-Based Processing * Extract segments for specific speakers when creating individual minds * Use speaker emails to accurately identify participants * Create separate minds for each unique speaker * Maintain speaker context when processing #### Transcript Quality * Fathom transcripts are typically high quality * Speaker attribution is accurate and reliable * Timestamps allow precise segment extraction * Email addresses enable accurate participant identification #### Integration Strategies * Combine transcripts from multiple meetings for richer training * Filter to specific topics or conversation types * Use speaker emails to track participants across meetings * Preserve metadata (date, title) for context ## Integration with Mind Reasoner ### Creating Minds from Fathom Transcripts #### List Meetings Use `fathom_list_meetings` to find meetings with target participants #### Get Transcript Use `fathom_get_transcript` to retrieve the full conversation #### Extract Speaker Segments Filter transcript to segments from the target speaker #### Create Mind Use Mind Reasoner's `create_mind` with speaker details #### Upload Transcript Upload the filtered transcript as training data #### Train Create snapshot and wait for training to complete **Natural language example:** ``` "Create minds for all participants in my leadership team meetings from the last quarter" ``` ## See Also #### [fathom_list_meetings](/mcp-tool-fathom-list-meetings) Find meetings before retrieving transcripts #### [fathom_get_meeting_details](/mcp-tool-fathom-get-meeting-details) Get meeting summaries and action items #### [create_mind](/mcp-tool-create-mind) Create minds from Fathom transcripts #### [Fathom Tools Overview](/mcp-integrations-fathom) See all Fathom tools and workflows