* Rename voice-control to hex everywhere, without migrations The Cargo package and binary are now hex, every OS keeps its data in a hex folder, and VOICE_CONTROL_* variables are HEX_*. Hex is a fresh app: the macOS voice-control rename, its symlink, and the Windows and Linux beta settings imports are gone. The Windows installer gets a new AppId so it never takes over an old voice-control install's entry. * Format * Drop the Windows paste-last default only the beta import used
3.3 KiB
Granola Import (research, not implemented)
Goal: bring older Granola meetings into Hex's meeting format so hex mcp
can search them beside Hex recordings. Researched from Granola's public docs on
2026-10-15; nothing was logged into, called, or decrypted.
Official Paths
Granola desktop
├── CSV export // Settings > Profile > Generate CSV
│ ├── Emailed link, valid 24 h, opened while signed in; 1 export / 24 h
│ ├── Title, summary, transcript, basic details; full history, including
│ │ notes older than 30 days on Basic (free)
│ ├── Only notes you own that have a summary; no deleted notes
│ └── On by default for Basic and Business; Enterprise admins may disable
├── Personal API // https://public-api.granola.ai/v1
│ ├── Bearer grn_ key from Settings > Connectors > API keys
│ ├── Business plan members (Enterprise: admin-gated scopes)
│ ├── GET /v1/notes (created_after, cursor), GET /v1/notes/{not_…}
│ └── GET /v1/notes/{id}/transcript: items with speaker.source
│ microphone|speaker, attribution, optional name, start_time/end_time
└── Granola MCP // https://mcp.granola.ai/mcp, OAuth
├── Basic: personal notes from the last 30 days; transcript tool paid only
└── Business: full history, get_meeting_transcript
Sources: Exporting historical notes, Granola API, Get Transcript, Granola MCP. Granola also documents transcript auto-deletion; check that setting before assuming old transcripts still exist.
The local cache on the Pro (cache-v6.json.enc, granola.db) is encrypted.
Do not reverse-engineer it; third-party scripts that do are unofficial.
Mapping To Hex
Granola's macOS transcript sources map directly: microphone -> You
(MeetingSource::Microphone), speaker -> Them (System). Absolute
start_time/end_time become offsets from the first item. A note becomes a
folder meetings/granola-<not_id>/ with a manifest.json (status complete,
created_at_ms from the meeting start, app: "Granola import", title), a
transcript.ndjson, and a transcript.md so the folder reads as published.
Granola summaries are not Hex notes; keep them in a separate field or a
Markdown file rather than impersonating Apple Intelligence notes.
Recommendation
- Kit runs the CSV export once (free on his plan, full history, no API key).
- A one-shot importer (
hex meeting import-granola <csv>, debug first) writes folders atomically, skips ids that already exist, and never overwrites. CSV transcripts may lack timestamps or speaker sources; check one real row before designing the parser, and fall back to a singleThemstream with zero offsets if they do. - Use the Personal API only if the CSV lacks speaker sources or times and Kit
is on Business; it needs a stored
grn_key, so ask Kit first.
Open questions: Kit's Granola plan, whether the CSV transcript column keeps microphone/speaker attribution and timing, and whether auto-deletion removed older transcripts.