# transcript1

Transcribes social media clips and recordings directly in your coding assistant. Delivers plain text, timestamps, and subtitles without leaving the terminal.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: transcript1-com
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/transcript1-com/mcp
- Updated: 2026-10-18
- HTML: https://affpapa.org/en/nevibecode/mcp/transcript1

## What it does

The connector links your coding client with the transcript1 backend via an `npx -y @transcript1/mcp` stdio runner. It processes links from YouTube, Bluesky, TikTok, Instagram, Facebook, and X. Output comes back with chronological timestamps and speaker separation when available.

Local sound and video tracks travel over a chunked upload pipeline. You can check partial transfer progress and resume if packets drop. Completed jobs convert into plain text, JSON, SRT, or VTT files, with paging support for lengthy speeches.

The bridge stops working without Node.js 18 and a valid `TRANSCRIPT1_API_KEY` token starting with `t1_`. You configure this variable inside your client environment so the stdio wrapper can reach the remote endpoint securely.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.transcript1.com/mcp`
- Environment variables: `TRANSCRIPT1_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://api.transcript1.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env TRANSCRIPT1_API_KEY=<TRANSCRIPT1_API_KEY> --transport stdio transcript1 -- npx -y @transcript1/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add transcript1 --url https://api.transcript1.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add transcript1 --env TRANSCRIPT1_API_KEY=<TRANSCRIPT1_API_KEY> -- npx -y @transcript1/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "transcript1": {
            "url": "https://api.transcript1.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "transcript1": {
            "command": "npx",
            "args": [
                "-y",
                "@transcript1/mcp"
            ],
            "env": {
                "TRANSCRIPT1_API_KEY": "<TRANSCRIPT1_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "transcript1": {
            "type": "http",
            "url": "https://api.transcript1.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "transcript1": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@transcript1/mcp"
            ],
            "env": {
                "TRANSCRIPT1_API_KEY": "<TRANSCRIPT1_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http transcript1 https://api.transcript1.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e TRANSCRIPT1_API_KEY=<TRANSCRIPT1_API_KEY> transcript1 npx -y @transcript1/mcp
```
Replace <…> with your own values

## When to use it
- extract text and speaker names from a YouTube or X link
- produce SRT or VTT subtitle tracks from online recordings
- send local multimedia files via segmented uploads
- monitor remaining subscription minutes and billing dates

## Example prompts
- Transcribe the video at this Bluesky link and label each speaker
- Fetch the transcript from job 42 in SRT format
- Check my transcript1 account balance and renewal date

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107701
- [Agent Skills Search Server](https://affpapa.org/en/nevibecode/mcp/agent-skills-search-server.md) — MCP server · ★ 26673
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [PraisonAI](https://affpapa.org/en/nevibecode/mcp/praisonai.md) — MCP server · ★ 9298

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md