DeLive Transcript Analyzer
Analyze and extract insights from real-time transcription sessions captured by DeLive, a desktop app for live speech-to-text.
Prerequisites
- DeLive must be running locally (REST API at
http://localhost:23456)
- For MCP integration, the DeLive MCP server must be configured (see Setup below)
Setup
Option A: MCP Server (recommended for Claude Desktop / Claude Code)
The DeLive MCP server provides direct tool access. Add to your MCP config:
{
"mcpServers": {
"delive": {
"command": "node",
"args": ["<PATH_TO_DELIVE>/mcp/delive-mcp-server.js"]
}
}
}
Option B: REST API (for any client)
DeLive exposes a local REST API when running:
- Base URL:
http://localhost:23456/api/v1/
- WebSocket live stream:
ws://localhost:23456/ws/live
Available Tools (via MCP)
| Tool |
Purpose |
search_transcripts |
Find sessions by keyword in title or transcript content |
get_session |
Full session with transcript, corrected transcript, AI summary, mind map, Q&A |
get_session_transcript |
Transcript text + corrected transcript (when available) |
get_session_summary |
AI summary, action items, keywords, mind map |
get_recording_status |
Check if DeLive is currently recording |
list_topics |
List topic categories for organizing sessions |
list_tags |
List all tags used to label sessions |
Available Resources (via MCP)
| Resource URI |
Description |
delive://sessions/recent |
Most recent 10 sessions (metadata) |
delive://status |
Current app and recording status |
Workflow Patterns
Pattern 1: Meeting Summary to Email Draft
- Search for the relevant meeting:
search_transcripts("weekly standup")
- Get the full session:
get_session("<session_id>")
- Use the transcript and AI summary to draft a follow-up email
Pattern 2: Lecture Notes to Study Guide
- Find the lecture:
search_transcripts("machine learning lecture")
- Get the transcript:
get_session_transcript("<session_id>")
- Extract key concepts, create flashcards, or generate a structured study guide
Pattern 3: Code Discussion to Implementation
- Search for the discussion:
search_transcripts("refactor database layer")
- Get session details:
get_session("<session_id>")
- Extract technical decisions and action items from the summary
- Generate implementation code based on the discussed approach
Pattern 4: Multi-Session Analysis
- Search broadly:
search_transcripts("project alpha")
- Retrieve summaries for each matching session
- Synthesize a cross-session report: timeline, decisions made, open items
Pattern 5: Best-Quality Transcript
- Get the transcript:
get_session_transcript("<session_id>")
- Check if a corrected transcript is present (returned as a separate section)
- Prefer the corrected version for downstream processing (summaries, translations, reports)
Pattern 6: Real-Time Monitoring
Connect to the live WebSocket for real-time transcript access:
import asyncio
import websockets
import json
async def monitor():
async with websockets.connect("ws://localhost:23456/ws/live") as ws:
async for message in ws:
data = json.loads(message)
if data["type"] == "transcript":
print(data["stableText"])
asyncio.run(monitor())
REST API Reference
All endpoints return JSON. Base URL: http://localhost:23456
| Method |
Endpoint |
Description |
| GET |
/api/v1/health |
Server health and version |
| GET |
/api/v1/sessions |
List sessions (params: search, limit, offset, topicId, status) |
| GET |
/api/v1/sessions/:id |
Full session detail |
| GET |
/api/v1/sessions/:id/transcript |
Transcript text + corrected transcript |
| GET |
/api/v1/sessions/:id/summary |
AI summary and mind map |
| GET |
/api/v1/topics |
All topics |
| GET |
/api/v1/tags |
All tags |
| GET |
/api/v1/status |
Recording state and app info |
Tips
- Search is case-insensitive and matches both title and transcript content
- Sessions with
status: "completed" have full transcripts; "recording" means in-progress
- The
hasSummary field in session listings indicates whether AI post-processing has been run
- Use
limit and offset for pagination when there are many sessions
- The live WebSocket at
/ws/live broadcasts both transcript updates and session lifecycle events (session-start, session-end)
- Corrected transcript:
get_session_transcript returns a correctedTranscript field when AI correction has been applied. Prefer this over the raw transcript for higher accuracy
- get_session includes a
Corrected Transcript section when available — use it for summaries, reports, and analysis
Error Handling
If DeLive is not running, all API calls will fail with a connection error. Check:
- DeLive app is open and running
- The built-in server is active (check
http://localhost:23456/api/v1/health)
- For MCP: the MCP server process can reach DeLive on localhost
Source: XimilalaXiang/DeLive — distributed by TomeVault.
1---2name: ximilalaxiang-delive-delive3description: DeLive Transcript Analyzer4---56# DeLive Transcript Analyzer78Analyze and extract insights from real-time transcription sessions captured by DeLive, a desktop app for live speech-to-text.910## Prerequisites1112- **DeLive** must be running locally (REST API at `http://localhost:23456`)13- For MCP integration, the DeLive MCP server must be configured (see Setup below)1415## Setup1617### Option A: MCP Server (recommended for Claude Desktop / Claude Code)1819The DeLive MCP server provides direct tool access. Add to your MCP config:2021```json22{23 "mcpServers": {24 "delive": {25 "command": "node",26 "args": ["<PATH_TO_DELIVE>/mcp/delive-mcp-server.js"]27 }28 }29}30```3132### Option B: REST API (for any client)3334DeLive exposes a local REST API when running:3536- Base URL: `http://localhost:23456/api/v1/`37- WebSocket live stream: `ws://localhost:23456/ws/live`3839## Available Tools (via MCP)4041| Tool | Purpose |42|------|---------|43| `search_transcripts` | Find sessions by keyword in title or transcript content |44| `get_session` | Full session with transcript, corrected transcript, AI summary, mind map, Q&A |45| `get_session_transcript` | Transcript text + corrected transcript (when available) |46| `get_session_summary` | AI summary, action items, keywords, mind map |47| `get_recording_status` | Check if DeLive is currently recording |48| `list_topics` | List topic categories for organizing sessions |49| `list_tags` | List all tags used to label sessions |5051## Available Resources (via MCP)5253| Resource URI | Description |54|-------------|-------------|55| `delive://sessions/recent` | Most recent 10 sessions (metadata) |56| `delive://status` | Current app and recording status |5758## Workflow Patterns5960### Pattern 1: Meeting Summary to Email Draft61621. Search for the relevant meeting: `search_transcripts("weekly standup")`632. Get the full session: `get_session("<session_id>")`643. Use the transcript and AI summary to draft a follow-up email6566### Pattern 2: Lecture Notes to Study Guide67681. Find the lecture: `search_transcripts("machine learning lecture")`692. Get the transcript: `get_session_transcript("<session_id>")`703. Extract key concepts, create flashcards, or generate a structured study guide7172### Pattern 3: Code Discussion to Implementation73741. Search for the discussion: `search_transcripts("refactor database layer")`752. Get session details: `get_session("<session_id>")`763. Extract technical decisions and action items from the summary774. Generate implementation code based on the discussed approach7879### Pattern 4: Multi-Session Analysis80811. Search broadly: `search_transcripts("project alpha")`822. Retrieve summaries for each matching session833. Synthesize a cross-session report: timeline, decisions made, open items8485### Pattern 5: Best-Quality Transcript86871. Get the transcript: `get_session_transcript("<session_id>")`882. Check if a corrected transcript is present (returned as a separate section)893. Prefer the corrected version for downstream processing (summaries, translations, reports)9091### Pattern 6: Real-Time Monitoring9293Connect to the live WebSocket for real-time transcript access:9495```python96import asyncio97import websockets98import json99100async def monitor():101 async with websockets.connect("ws://localhost:23456/ws/live") as ws:102 async for message in ws:103 data = json.loads(message)104 if data["type"] == "transcript":105 print(data["stableText"])106107asyncio.run(monitor())108```109110## REST API Reference111112All endpoints return JSON. Base URL: `http://localhost:23456`113114| Method | Endpoint | Description |115|--------|----------|-------------|116| GET | `/api/v1/health` | Server health and version |117| GET | `/api/v1/sessions` | List sessions (params: `search`, `limit`, `offset`, `topicId`, `status`) |118| GET | `/api/v1/sessions/:id` | Full session detail |119| GET | `/api/v1/sessions/:id/transcript` | Transcript text + corrected transcript |120| GET | `/api/v1/sessions/:id/summary` | AI summary and mind map |121| GET | `/api/v1/topics` | All topics |122| GET | `/api/v1/tags` | All tags |123| GET | `/api/v1/status` | Recording state and app info |124125## Tips126127- **Search is case-insensitive** and matches both title and transcript content128- Sessions with `status: "completed"` have full transcripts; `"recording"` means in-progress129- The `hasSummary` field in session listings indicates whether AI post-processing has been run130- Use `limit` and `offset` for pagination when there are many sessions131- The live WebSocket at `/ws/live` broadcasts both transcript updates and session lifecycle events (`session-start`, `session-end`)132- **Corrected transcript**: `get_session_transcript` returns a `correctedTranscript` field when AI correction has been applied. Prefer this over the raw transcript for higher accuracy133- **get_session** includes a `Corrected Transcript` section when available — use it for summaries, reports, and analysis134135## Error Handling136137If DeLive is not running, all API calls will fail with a connection error. Check:1381. DeLive app is open and running1392. The built-in server is active (check `http://localhost:23456/api/v1/health`)1403. For MCP: the MCP server process can reach DeLive on localhost141142---143> Source: [XimilalaXiang/DeLive](https://github.com/XimilalaXiang/DeLive) — distributed by [TomeVault](https://tomevault.io).144<!-- tomevault:4.0:skill_md:2026-06-24 -->