pocket-transcripts – OpenClaw Skill

---

name: pocket-transcripts description: Read transcripts and summaries from Pocket AI (heypocket.com) recording devices. Use when users want to retrieve, search, or analyze their Pocket recordings, transcripts, summaries, or action items. Triggers on requests involving Pocket device data, conversation transcripts, meeting recordings, or audio note retrieval.

Pocket Transcripts

Read transcripts and summaries from Pocket AI devices via reverse-engineered API.

Quick Reference

Function	Description
get_recordings(days, limit)	List recent recordings
get_recording_full(id)	Get transcript + summary + action items
get_transcript(id)	Get raw transcript text
get_summarization(id)	Get markdown summary
search_recordings(query)	Search by text

Setup (One-Time)

1. Start Chrome with User Profile

~/.factory/skills/browser/start.js --profile
# or
~/.claude/skills/browser/start.js --profile

2. Log into Pocket

Navigate to and log in:

~/.factory/skills/browser/nav.js https://app.heypocket.com

3. Extract Token

python3 scripts/reader.py extract

Token is saved to ~/.pocket_token.json and expires in 1 hour.

Usage

List Recordings

from pathlib import Path
import sys
sys.path.insert(0, str(Path.home() / '.claude/skills/pocket-transcripts/scripts'))
from reader import get_recordings, get_recording_full

recordings = get_recordings(days=30, limit=20)
for r in recordings:
    print(f"{r.recorded_at:%Y-%m-%d} | {r.duration_str} | {r.title}")

Get Full Transcript and Summary

full = get_recording_full(recording_id)

print(f"Transcript ({len(full['transcript'])} chars):")
print(full['transcript'][:500])

print(f"\nSummary (markdown):")
print(full['summary'])

print(f"\nAction Items: {len(full['action_items'])}")
for item in full['action_items']:
    print(f"  - {item}")

Search Recordings

results = search_recordings("meeting", days=90)
for r in results:
    print(f"{r.title} - {r.description[:100]}")

API Details

Base URL: https://production.heypocketai.com/api/v1

Auth: Firebase Bearer token from browser IndexedDB

Key Endpoints:

• GET /recordings - List with pagination, filters
• GET /recordings/{id}?include=all - Full data with transcript/summary

Data Structure:

• Transcript: data.transcription.transcription.text
• Summary: data.summarizations[id].v2.summary.markdown
• Action Items: data.summarizations[id].v2.actionItems.items

Token Refresh

Firebase tokens expire in 1 hour. When expired:

1. Ensure Chrome is running with --profile
2. Confirm logged into app.heypocket.com
3. Re-run: python3 scripts/reader.py extract

Data Model

PocketRecording

• id, title, description
• duration (seconds), duration_str (human readable)
• recorded_at, created_at
• has_transcription, has_summarization
• num_speakers
• latitude, longitude (if location enabled)
• tags (list of strings)

PocketSummarization

• summary (markdown formatted)
• action_items (list)
• transcript (raw text)

Pocket Transcripts Skill

A Claude Code skill for reading transcripts and summaries from Pocket AI recording devices.

What is Pocket?

Pocket is an AI-powered wearable device that records conversations and generates transcripts, summaries, and action items. This skill provides programmatic access to your Pocket data via their unofficial API.

Features

• List recordings with metadata (title, duration, date, speakers)
• Get full transcripts of recorded conversations (50k+ characters)
• Get AI summaries in markdown format
• Extract action items from recordings
• Search recordings by text

Installation

For Claude Code Users

Download the .skill file from Releases and add it to your Claude Code skills.

Manual Installation

# Clone to your skills directory
git clone https://github.com/YOUR_USERNAME/pocket-transcripts-skill.git ~/.claude/skills/pocket-transcripts

Setup

Prerequisites

1. A Pocket account with recordings
2. The browser skill installed
3. Chrome browser

Authentication

Pocket uses Firebase authentication. To extract your token:

1. Start Chrome with your profile:

   ~/.claude/skills/browser/start.js --profile
   

2. Navigate to Pocket and log in:

   ~/.claude/skills/browser/nav.js https://app.heypocket.com
   

3. Extract the token:

   python3 ~/.claude/skills/pocket-transcripts/scripts/reader.py extract
   

The token is saved to ~/.pocket_token.json and expires in 1 hour.

Usage

CLI

# List recent recordings
python3 scripts/reader.py

# List recordings from last 7 days
python3 scripts/reader.py 7

Python

from reader import get_recordings, get_recording_full, search_recordings

# List recordings
recordings = get_recordings(days=30, limit=20)
for r in recordings:
    print(f"{r.recorded_at:%Y-%m-%d} | {r.duration_str} | {r.title}")

# Get full transcript and summary
full = get_recording_full(recording_id)
print(full['transcript'])  # Raw text
print(full['summary'])     # Markdown

# Search
results = search_recordings("meeting")

API Reference

Function	Description
get_recordings(days, limit)	List recent recordings
get_recording_full(id)	Get transcript + summary + action items + speakers
get_transcript(id)	Get raw transcript text
get_summarization(id)	Get markdown summary
search_recordings(query, days, limit)	Search recordings by text

Technical Details

• API Base: https://production.heypocketai.com/api/v1
• Auth: Firebase Bearer token from browser IndexedDB
• Token Expiry: 1 hour (Firebase default)

This skill was created by reverse-engineering the Pocket web app at app.heypocket.com.

License

MIT License - See LICENSE for details.

Disclaimer

This is an unofficial integration. Use at your own risk. Not affiliated with or endorsed by Pocket/Open Vision Engineering Inc.