Granola MCP Server

Instructions

Implementation Reference

• src/server.ts:195-233 (handler)

  Complete implementation of get_meeting_details tool including schema registration (name, description, parameters) and execute handler function that retrieves meeting details from cache and formats them
  // Tool: get_meeting_details server.addTool({ name: 'get_meeting_details', description: 'Get detailed information about a specific meeting', parameters: z.object({ meeting_id: z.string().describe('Meeting ID to retrieve details for') }), execute: async ({ meeting_id }) => { await ensureDataLoaded(); const doc = documentsCache.get(meeting_id); if (!doc) { return `Meeting '${meeting_id}' not found`; } const details: string[] = [ `# Meeting Details: ${getTitle(doc)}\n`, `**ID:** ${doc.id}`, `**Date:** ${formatDate(doc.created_at)}`, `**Updated:** ${formatDate(doc.updated_at)}` ]; if (doc.workspace_name) { details.push(`**Workspace:** ${doc.workspace_name}`); } if (doc.folders && doc.folders.length > 0) { const folderNames = doc.folders.map(f => f.name).join(', '); details.push(`**Folders:** ${folderNames}`); } if (doc.people && doc.people.length > 0) { const people = doc.people.map(p => p.name).join(', '); details.push(`**Participants:** ${people}`); } return details.join('\n'); } });
• src/server.ts:199-201 (schema)

  Input parameter schema definition using Zod - requires a meeting_id string parameter
  parameters: z.object({ meeting_id: z.string().describe('Meeting ID to retrieve details for') }),
• src/types.ts:69-80 (schema)

  GranolaDocument interface type definition that defines the structure of meeting data retrieved and displayed by get_meeting_details
  export interface GranolaDocument { id: string; title: string; created_at: string; updated_at: string; workspace_id?: string; workspace_name?: string; folders?: FolderInfo[]; last_viewed_panel?: DocumentPanel; people?: Array<{ name: string }>; [key: string]: any; }
• src/server.ts:30-60 (helper)

  ensureDataLoaded and loadData helper functions that populate the documentsCache with meeting data before the tool executes
  async function ensureDataLoaded() { const now = Date.now(); if (documentsCache.size === 0 || (now - lastFetchTime) > CACHE_TTL) { await loadData(); } } /** * Load data from Granola API */ async function loadData() { console.error('Fetching data from Granola API...'); const data = await apiClient.getAllDocumentsWithMetadata(); if (!data) { console.error('Failed to fetch data from API'); return; } // Update caches documentsCache.clear(); for (const doc of data.documents) { documentsCache.set(doc.id, doc); } workspacesCache = data.workspaces; foldersCache = data.documentLists; lastFetchTime = Date.now(); console.error(`Loaded ${documentsCache.size} documents from API`); }
• src/server.ts:62-94 (helper)

  Helper functions formatDate and getTitle used by get_meeting_details to format meeting dates and extract titles safely
  /** * Format date in local timezone */ function formatDate(dateStr: string | null | undefined): string { if (!dateStr) return 'Unknown date'; try { const date = new Date(dateStr); return date.toLocaleString('en-US', { year: 'numeric', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit', hour12: false }); } catch { return dateStr; } } /** * Safe string for searching (handles null/undefined) */ function safeString(str: string | null | undefined): string { return str || ''; } /** * Get document title safely */ function getTitle(doc: GranolaDocument): string { return doc.title || 'Untitled Meeting'; }