1export const granolaIntegrationSpec = defineIntegration({
2  meta: {
3    key: 'meeting-recorder.granola',
4    version: '1.0.0',
5    category: 'meeting-recorder',
6    title: 'Granola Meeting Notes',
7    description:
8      'Granola meeting notes and transcripts via Enterprise API or MCP transport.',
9    domain: 'productivity',
10    owners: ['platform.integrations'],
11    tags: ['meeting-recorder', 'granola', 'transcripts'],
12    stability: StabilityEnum.Experimental,
13  },
14  supportedModes: ['byok'],
15  capabilities: {
16    provides: [
17      { key: 'meeting-recorder.meetings.read', version: '1.0.0' },
18      { key: 'meeting-recorder.transcripts.read', version: '1.0.0' },
19    ],
20  },
21  configSchema: {
22    schema: {
23      type: 'object',
24      properties: {
25        baseUrl: {
26          type: 'string',
27          description:
28            'Optional override for the Granola API base URL. Defaults to https://public-api.granola.ai for API transport.',
29        },
30        transport: {
31          type: 'string',
32          enum: ['api', 'mcp'],
33          description:
34            'Transport mode for Granola integration. Use api for Enterprise API or mcp for broader MCP access.',
35        },
36        mcpUrl: {
37          type: 'string',
38          description:
39            'Optional override for Granola MCP URL. Defaults to https://mcp.granola.ai/mcp.',
40        },
41        mcpHeaders: {
42          type: 'object',
43          additionalProperties: { type: 'string' },
44          description: 'Optional static headers for MCP gateway/proxy setups.',
45        },
46        pageSize: {
47          type: 'number',
48          description:
49            'Page size for listing notes (maximum 30 per Granola API).',
50        },
51      },
52    },
53    example: {
54      transport: 'mcp',
55      mcpUrl: 'https://mcp.granola.ai/mcp',
56      pageSize: 10,
57    },
58  },
59  secretSchema: {
60    schema: {
61      type: 'object',
62      properties: {
63        apiKey: {
64          type: 'string',
65          description:
66            'Granola API key used as a Bearer token for Enterprise API requests (transport=api).',
67        },
68        mcpAccessToken: {
69          type: 'string',
70          description:
71            'Optional bearer token for MCP proxy/gateway auth (transport=mcp).',
72        },
73      },
74    },
75    example: {
76      mcpAccessToken: 'granola-mcp-***',
77    },
78  },
79  healthCheck: {
80    method: 'list',
81    timeoutMs: 8000,
82  },
83  docsUrl: 'https://docs.granola.ai/help-center/sharing/integrations/mcp',
84  byokSetup: {
85    setupInstructions:
86      'Use Granola MCP for browser OAuth access, or configure an Enterprise API key for REST transport.',
87  },
88});