Recall.ai Import

Automatischer Import deiner gespeicherten Recall-Cards in dein Personal Brain als source-Brains. Keine Copy-Paste-Schmerzen mehr — taggst du eine Card in Recall mit deinem konfigurierten Tag, landet sie beim nächsten Sync als Markdown in deinem Brain.

Nur auf Personal-Instanzen. Business-Instanzen blenden das Menü aus. Kategorie: source. Deduplikation über eine interne Tabelle — Card-IDs werden nie doppelt importiert.


Was importiert wird

Jede Recall-Card mit passendem Tag wird zu einem Brain:

Feld Wert
id <slug>.source.recall-<card-id>
category source
type document
title Titel der Card
date Import-Datum (YYYY-MM-DD)
tags ["recall", "import"]
Body Titel + Quellen-URL + Recall-Card-ID + alle Content-Chunks

Bereits importierte Cards (anhand ihrer Recall-ID) werden beim nächsten Sync übersprungen. Löschst du das Brain später im GTS, wird es beim nächsten Sync nicht wieder erstellt — der Dedup-Eintrag bleibt bestehen.


Setup

1. API-Key in Recall holen

In Recall → SettingsAPI & MCPGenerate API Key. Der Key hat das Format sk_.... Kopieren.

2. GTS öffnen

Sidebar → EinstellungenRecall.ai Import.

3. Formular ausfüllen

Feld Wert
API-Key den sk_...-Key von oben
Tag-IDs UUIDs deiner Recall-Tags, kommagetrennt (siehe nächster Abschnitt)
Max Chunks pro Card 20 reicht meistens. Erhöhen nur wenn lange Artikel abgeschnitten werden.
Integration aktiv anhaken

4. Speichern → Test → Sync

  • Klick Speichern
  • Klick Test: Cards auflisten — zeigt Preview der ersten 10 Cards die matchen. Wenn 0 erscheinen: falscher Tag oder falscher Key.
  • Klick Jetzt synchronisieren → importiert alle neuen Cards.

Unter /brains siehst du sie dann mit Kategorie source und Tag recall.


Tag-UUIDs finden — das knifflige Teil

Recall's API filtert nach Tag-UUIDs, nicht Tag-Namen. Die UUIDs sind in der Recall-Web-UI nicht sichtbar (URLs zeigen nur Item-IDs).

Lösung: Der Tags entdecken-Button probiert mehrere API-Pfade und liest Tags auch aus Card-Details. Wenn deine Tags angezeigt werden, klick Übernehmen — die UUID landet direkt im Feld.

Funktioniert das nicht (manche Recall-Konten haben keine REST-Tag-Liste), gibt's diese Workarounds:

  1. Browser DevTools: app.recall.it öffnen → DevTools → Network-Tab → auf einen Tag klicken → Request-URL enthält die UUID.
  2. Card-Detail direkt abfragen:
    curl -H "Authorization: Bearer sk_..." \
      "https://backend.getrecall.ai/api/v1/cards/<CARD-UUID>"
    
    In der Response stehen die zugehörigen Tags mit ihren UUIDs (falls Recall sie zurückgibt).

Sync-Trigger

Jetzt: manuell via Button in den Settings, oder via Cron von aussen:

# z.B. systemd timer, alle 15 min
curl -X POST -b "gts_session=<your-session-cookie>" \
  https://<your-brain>/api/integrations/recall/sync

Kommt (nicht implementiert): interner Intervall-Scheduler im Server — sobald du's willst, sag Bescheid.


Was nicht importiert wird

  • Cards ohne den konfigurierten Tag.
  • Cards die schon einmal importiert wurden (Dedup-Tabelle recall_imports).
  • Card-Content jenseits der konfigurierten max_chunks — Recall gibt bei langen Artikeln gekürzte Chunks zurück. Erhöhe den Wert wenn das zu wenig ist.

Datenschutz

  • API-Key wird im instance-lokalen SQLite (meta.sqlite) gespeichert, unverschlüsselt. Disk-Encryption (FileVault / LUKS) absichern.
  • Beim Löschen der Integration (Toggle aus + Speichern) bleibt der Key im Record. Zum kompletten Entfernen: sqlite3 /var/lib/gts-*/.gts/meta.sqlite "DELETE FROM integrations WHERE provider='recall';".
  • Card-Inhalte landen 1:1 als Markdown in deinen Brains → Git-Commit + normaler GTS-Workflow. Bei Secrets in Cards → vorher in Recall aufräumen.

Troubleshooting

"0 Cards gelistet" obwohl Cards mit Tag existieren → Du hast den Tag-Namen statt der UUID eingegeben. Klick Tags entdecken oder nutze die Workarounds oben.

"HTTP 401 Unauthorized" → API-Key ist abgelaufen oder rotiert. Neuen Key in Recall generieren.

"NOT_CONFIGURED" / "DISABLED" → Integration ist nicht gespeichert oder Toggle ist aus. Settings → Speichern.

Importierte Brains haben falschen Titel / keine URL → Recall gibt nicht für alle Cards einen sauberen Titel zurück. Fallback ist Recall card <id>. Brain nachträglich editieren.