fellow-mcp 1.0.3 → 1.0.5

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.4] - 2026-01-28
+
+### Fixed
+- `search_meetings` now shows actual meeting times instead of "N/A" by enriching recordings with event_start from associated notes
+- Automatically fetches note data from Fellow API if not in local database to get accurate meeting times
+- Fixed `getNote` API method to properly parse response structure
+
+### Changed
+- Removed confusing `created_at` field from `search_meetings` results (was showing when meeting was logged, not when it occurred)
+- `search_meetings` now displays actual meeting times in local timezone for better user experience
+
 ## [1.0.3] - 2026-01-27
 
 ### Added
@@ -51,7 +62,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Full-text search across cached notes
 - Find meetings by participant
 
-[Unreleased]: https://github.com/liba2k/fellow-mcp/compare/v1.0.3...HEAD
+[Unreleased]: https://github.com/liba2k/fellow-mcp/compare/v1.0.4...HEAD
+[1.0.4]: https://github.com/liba2k/fellow-mcp/compare/v1.0.3...v1.0.4
 [1.0.3]: https://github.com/liba2k/fellow-mcp/compare/v1.0.2...v1.0.3
 [1.0.2]: https://github.com/liba2k/fellow-mcp/compare/v1.0.1...v1.0.2
 [1.0.1]: https://github.com/liba2k/fellow-mcp/compare/v1.0.0...v1.0.1

package/dist/index.js

@@ -84,6 +84,40 @@ class FellowClient {
     async getRecording(recordingId) {
         return this.request("GET", `/recording/${recordingId}`);
     }
+    /**
+     * Fetch a single recording with its transcript.
+     * Tries GET /recording/{id} first (which may include transcript).
+     * If transcript is missing, falls back to POST /recordings with include.transcript
+     * and paginates until the recording is found.
+     */
+    async getRecordingWithTranscript(recordingId) {
+        // Try direct fetch first - single resource endpoints often return full object
+        try {
+            const recording = await this.getRecording(recordingId);
+            if (recording && recording.transcript) {
+                return recording;
+            }
+            // If we got the recording but no transcript, fall back to list with include
+        }
+        catch {
+            // Direct fetch failed, fall back to list endpoint
+        }
+        // Fall back to list with transcript include, paginating until we find it
+        let cursor;
+        do {
+            const resp = await this.listRecordings({
+                include_transcript: true,
+                cursor,
+                page_size: 50,
+            });
+            const found = resp.recordings.data.find((r) => r.id === recordingId);
+            if (found) {
+                return found;
+            }
+            cursor = resp.recordings.page_info.cursor ?? undefined;
+        } while (cursor);
+        return null;
+    }
     async listNotes(options) {
         const body = {};
         // Build filters
@@ -122,7 +156,8 @@ class FellowClient {
         return this.request("POST", "/notes", body);
     }
     async getNote(noteId) {
-        return this.request("GET", `/note/${noteId}`);
+        const response = await this.request("GET", `/note/${noteId}`);
+        return response.note;
     }
 }
 // Tool definitions
@@ -589,8 +624,8 @@ function formatTranscript(transcript) {
     }
     let output = `Language: ${transcript.language_code}\n\n`;
     for (const segment of transcript.speech_segments) {
-        const startTime = formatTime(segment.start_time);
-        const endTime = formatTime(segment.end_time);
+        const startTime = formatTime(segment.start ?? segment.start_time ?? 0);
+        const endTime = formatTime(segment.end ?? segment.end_time ?? 0);
         output += `[${startTime} - ${endTime}] ${segment.speaker}: ${segment.text}\n`;
     }
     return output;
@@ -654,17 +689,42 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     page_size: Math.min(limit ?? 20, 50),
                 });
                 const { subdomain } = parseArgs();
-                const results = recordingsResp.recordings.data.map((r) => ({
-                    id: r.id,
-                    title: r.title,
-                    note_id: r.note_id,
-                    event_start: r.event_start,
-                    event_start_local: formatDateTime(r.event_start),
-                    event_end: r.event_end,
-                    created_at: r.created_at,
-                    call_url: r.call_url,
-                    event_guid: r.event_guid,
-                    fellow_url: getFellowUrl(subdomain, r.event_guid),
+                const db = getDatabase();
+                // Enrich recordings with event_start from notes
+                // Use Promise.all to fetch notes from API in parallel if needed
+                const results = await Promise.all(recordingsResp.recordings.data.map(async (r) => {
+                    // Try to get event_start from the associated note
+                    let eventStart = r.event_start;
+                    if (!eventStart && r.note_id) {
+                        // First check local database
+                        const localNote = db.getNote(r.note_id);
+                        if (localNote?.event_start) {
+                            eventStart = localNote.event_start;
+                        }
+                        else {
+                            // If not in DB, fetch from API
+                            try {
+                                const apiNote = await client.getNote(r.note_id);
+                                if (apiNote?.event_start) {
+                                    eventStart = apiNote.event_start;
+                                }
+                            }
+                            catch (error) {
+                                // Silently fail - we'll just show N/A for event_start
+                            }
+                        }
+                    }
+                    return {
+                        id: r.id,
+                        title: r.title,
+                        note_id: r.note_id,
+                        event_start: eventStart,
+                        event_start_local: formatDateTime(eventStart),
+                        event_end: r.event_end,
+                        call_url: r.call_url,
+                        event_guid: r.event_guid,
+                        fellow_url: getFellowUrl(subdomain, r.event_guid),
+                    };
                 }));
                 return {
                     content: [
@@ -683,22 +743,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const { recording_id, meeting_title } = args;
                 let recordingWithTranscript = null;
                 if (recording_id) {
-                    // Get the specific recording with transcript
-                    const recordingsResp = await client.listRecordings({
-                        include_transcript: true,
-                        page_size: 50,
-                    });
-                    recordingWithTranscript =
-                        recordingsResp.recordings.data.find((r) => r.id === recording_id) ?? null;
-                    if (!recordingWithTranscript) {
-                        // Try fetching all to find it
-                        const allRecordingsResp = await client.listRecordings({
-                            include_transcript: true,
-                            page_size: 50,
-                        });
-                        recordingWithTranscript =
-                            allRecordingsResp.recordings.data.find((r) => r.id === recording_id) ?? null;
-                    }
+                    // Direct fetch by ID with transcript (paginates if needed)
+                    recordingWithTranscript = await client.getRecordingWithTranscript(recording_id);
                 }
                 else if (meeting_title) {
                     // Search by title and get transcript
@@ -739,10 +785,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 let targetRecordingId = recording_id;
                 // If recording_id provided, get the associated note_id
                 if (!noteId && recording_id) {
-                    const recordingsResp = await client.listRecordings({ page_size: 50 });
-                    const recording = recordingsResp.recordings.data.find((r) => r.id === recording_id);
-                    if (recording) {
-                        noteId = recording.note_id;
+                    try {
+                        const recording = await client.getRecording(recording_id);
+                        if (recording) {
+                            noteId = recording.note_id;
+                        }
+                    }
+                    catch {
+                        // Direct fetch failed, try list as fallback
+                        const recordingsResp = await client.listRecordings({ page_size: 50 });
+                        const recording = recordingsResp.recordings.data.find((r) => r.id === recording_id);
+                        if (recording) {
+                            noteId = recording.note_id;
+                        }
                     }
                 }
                 // If meeting_title provided, search for the note and recording
@@ -774,16 +829,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 let eventStart = null;
                 let eventGuid = null;
                 if (noteId) {
-                    const notesResp = await client.listNotes({
-                        include_content: true,
-                        page_size: 50,
-                    });
-                    const note = notesResp.notes.data.find((n) => n.id === noteId);
-                    if (note) {
-                        noteTitle = note.title;
-                        eventStart = note.event_start ?? null;
-                        eventGuid = note.event_guid ?? null;
-                        noteContent = note.content_markdown ?? null;
+                    // Direct fetch by ID - much more reliable than listing and filtering
+                    try {
+                        const note = await client.getNote(noteId);
+                        if (note) {
+                            noteTitle = note.title;
+                            eventStart = note.event_start ?? null;
+                            eventGuid = note.event_guid ?? null;
+                            noteContent = note.content_markdown ?? null;
+                        }
+                    }
+                    catch {
+                        // Note fetch failed, continue without note content
                     }
                 }
                 // Find recording ID if we don't have it
@@ -797,11 +854,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 // Fetch transcript
                 let transcriptText = null;
                 if (targetRecordingId) {
-                    const recordingsResp = await client.listRecordings({
-                        include_transcript: true,
-                        page_size: 50,
-                    });
-                    const recording = recordingsResp.recordings.data.find((r) => r.id === targetRecordingId);
+                    // Direct fetch by ID with transcript (paginates if needed)
+                    const recording = await client.getRecordingWithTranscript(targetRecordingId);
                     if (recording?.transcript) {
                         transcriptText = formatTranscript(recording.transcript);
                         if (!noteTitle || noteTitle === "Unknown Meeting") {
@@ -841,11 +895,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const { note_id, meeting_title } = args;
                 let note = null;
                 if (note_id) {
-                    const notesResp = await client.listNotes({
-                        include_content: true,
-                        page_size: 50,
-                    });
-                    note = notesResp.notes.data.find((n) => n.id === note_id) ?? null;
+                    // Direct fetch by ID
+                    try {
+                        note = await client.getNote(note_id);
+                    }
+                    catch {
+                        note = null;
+                    }
                 }
                 else if (meeting_title) {
                     const notesResp = await client.listNotes({
@@ -893,11 +949,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const { note_id, meeting_title } = args;
                 let note = null;
                 if (note_id) {
-                    const notesResp = await client.listNotes({
-                        include_attendees: true,
-                        page_size: 50,
-                    });
-                    note = notesResp.notes.data.find((n) => n.id === note_id) ?? null;
+                    // Direct fetch by ID
+                    try {
+                        note = await client.getNote(note_id);
+                    }
+                    catch {
+                        note = null;
+                    }
                 }
                 else if (meeting_title) {
                     const notesResp = await client.listNotes({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fellow-mcp",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "MCP server for Fellow.ai API - access meeting data, transcripts, summaries, and action items",
   "type": "module",
   "main": "dist/index.js",