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	transports: [{ type: 'rest' }, { type: 'mcp', transport: 'http' }],
16	preferredTransport: 'mcp',
17	supportedAuthMethods: [{ type: 'api-key' }, { type: 'bearer' }],
18	capabilities: {
19		provides: [
20			{ key: 'meeting-recorder.meetings.read', version: '1.0.0' },
21			{ key: 'meeting-recorder.transcripts.read', version: '1.0.0' },
22		],
23	},
24	configSchema: {
25		schema: {
26			type: 'object',
27			properties: {
28				baseUrl: {
29					type: 'string',
30					description:
31						'Optional override for the Granola API base URL. Defaults to https://public-api.granola.ai for API transport.',
32				},
33				transport: {
34					type: 'string',
35					enum: ['api', 'mcp'],
36					description:
37						'Transport mode for Granola integration. Use api for Enterprise API or mcp for broader MCP access.',
38				},
39				mcpUrl: {
40					type: 'string',
41					description:
42						'Optional override for Granola MCP URL. Defaults to https://mcp.granola.ai/mcp.',
43				},
44				mcpHeaders: {
45					type: 'object',
46					additionalProperties: { type: 'string' },
47					description: 'Optional static headers for MCP gateway/proxy setups.',
48				},
49				pageSize: {
50					type: 'number',
51					description:
52						'Page size for listing notes (maximum 30 per Granola API).',
53				},
54			},
55		},
56		example: {
57			transport: 'mcp',
58			mcpUrl: 'https://mcp.granola.ai/mcp',
59			pageSize: 10,
60		},
61	},
62	secretSchema: {
63		schema: {
64			type: 'object',
65			properties: {
66				apiKey: {
67					type: 'string',
68					description:
69						'Granola API key used as a Bearer token for Enterprise API requests (transport=api).',
70				},
71				mcpAccessToken: {
72					type: 'string',
73					description:
74						'Optional bearer token for MCP proxy/gateway auth (transport=mcp).',
75				},
76			},
77		},
78		example: {
79			mcpAccessToken: 'granola-mcp-***',
80		},
81	},
82	healthCheck: {
83		method: 'list',
84		timeoutMs: 8000,
85	},
86	docsUrl: 'https://docs.granola.ai/help-center/sharing/integrations/mcp',
87	byokSetup: {
88		setupInstructions:
89			'Use Granola MCP for browser OAuth access, or configure an Enterprise API key for REST transport.',
90		keyRotationSupported: false,
91		quotaTrackingSupported: false,
92	},
93});