hex/docs/plans/granola-import.md
Dax 3434eb5f35
Rename voice-control to hex everywhere, without migrations (#293)
* 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
2026-10-28 13:08:44 -04:00

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

  1. Kit runs the CSV export once (free on his plan, full history, no API key).
  2. 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 single Them stream with zero offsets if they do.
  3. 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.