ParrotScribe MCP Server (Deprecated) & Lex Copilot

[!WARNING] This MCP server is deprecated. It will continue to work for users who stay on Parrot Scribe versions before 0.4.0, but it will not work once you upgrade to 0.4.0 or newer. Use the integrated MCP server built into Parrot Scribe instead.

An MCP (Model Context Protocol) server that enables AI agents to interact with the ParrotScribe transcription service on macOS.

Meet Lex: Your Tactical Meeting Copilot

If you are using Opencode, I recommend that you use the pre-configured agent called Lex. Lex transforms passive transcription into an active research and navigation tool.

Real-time Context: Ask "What's that?" or "What did they just say?" to get instant explanations.
Zero-Latency Knowledge: Proactively loads domain-specific skills based on transcript keywords.
Tactical Summaries: Generates structured meeting notes, identifying key facts and action items.
Persona-Ready: Tailor Lex to any role (Journalist, Researcher, Engineer) via private directives.

Installing Lex

Ensure you are on Parrot Scribe < 0.4.0 and this MCP server is configured in your environment.
Copy agent/lex.md from this repository into your local .opencode/agent/ directory.

---

What It Does

ParrotScribe captures real-time audio from your microphone and system audio, transcribes it using Whisper, and this MCP server exposes that transcription data to AI agents. This enables workflows like:

Meeting Monitor: AI monitors a live call and surfaces relevant information
Action Item Tracker: AI detects commitments and prepares follow-up actions
Real-time Researcher: AI looks up technical terms mentioned in conversation
Session Summarizer: AI generates structured summaries after calls

Prerequisites

macOS with ParrotScribe installed
Node.js 18 or higher
The pscribe CLI must be available in your PATH (it will be if ParrotScribe is installed correctly)
Parrot Scribe version < 0.4.0 (once 0.4.0 is released, this package is unsupported)

Legacy Installation (Parrot Scribe < 0.4.0 only)

If you are using Parrot Scribe 0.4.0 (or newer), do not install this package. Use the app's integrated MCP server.

Option 1: NPX (Recommended)

No installation needed. Configure your AI agent to run:

npx @johanthoren/parrotscribe-mcp-server

Option 2: Global Install

npm install -g @johanthoren/parrotscribe-mcp-server

Then run with:

parrotscribe-mcp-server

Option 3: From Source

git clone https://github.com/johanthoren/parrotscribe-mcp.git
cd parrotscribe-mcp
npm install
npm run build
node dist/index.js

Configuration

Opencode

Add to your ~/.config/opencode/opencode.jsonc:

{
  "mcp": {
    "parrotscribe": {
      "type": "local",
      "command": ["npx", "@johanthoren/parrotscribe-mcp-server"]
    }
  }
}

Claude Code

Add to your project's .mcp.json or global MCP config:

{
  "mcpServers": {
    "parrotscribe": {
      "command": "npx",
      "args": ["@johanthoren/parrotscribe-mcp-server"]
    }
  }
}

Claude Desktop

Add to your claude_desktop_config.json (typically at ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "parrotscribe": {
      "command": "npx",
      "args": ["@johanthoren/parrotscribe-mcp-server"]
    }
  }
}

Environment Variables (Optional)

| Variable | Description | Default | |----------|-------------|---------| | PSCRIBE_PATH | Path to the pscribe executable. Only needed if pscribe is not in your PATH (edge case). | pscribe |

Available Tools

| Tool | Description | |------|-------------| | pscribe_start | Start real-time audio transcription | | pscribe_stop | Stop/pause the current transcription | | pscribe_status | Get service status, session ID, duration | | pscribe_tail | Get recent transcript entries with filtering | | pscribe_cat | Display complete sessions with time-based filtering | | pscribe_grep | Search for patterns across transcript sessions | | pscribe_sessions | List past transcription sessions | | pscribe_new | Force start a new session |

pscribe_tail Parameters

| Parameter | Type | Description | |-----------|------|-------------| | n | number | Number of entries to return (default: 10) | | since_line | number | Start from line N (for polling) | | status | string | Filter: all, confirmed, unconfirmed, translated, speech | | session_id | string | Read from a specific session |

pscribe_cat Parameters

| Parameter | Type | Description | |-----------|------|-------------| | session_ids | string[] | Session IDs to display (from pscribe_sessions) | | since | string | Show sessions starting after this ISO8601 timestamp | | until | string | Show sessions starting before this ISO8601 timestamp | | last | number | Show last N sessions | | status | string | Filter: all, confirmed, unconfirmed, speech |

Use pscribe_cat for historical queries like "summarize yesterday's standup" - the AI converts natural language time references to ISO8601.

pscribe_grep Parameters

| Parameter | Type | Description | |-----------|------|-------------| | pattern | string | The pattern to search for (regex supported) - required | | since | string | Only search sessions starting after this ISO8601 timestamp | | until | string | Only search sessions starting before this ISO8601 timestamp | | status | string | Filter: all, confirmed, unconfirmed, speech | | ignore_case | boolean | Case-insensitive search | | count | boolean | Show match count per session instead of matches | | after_context | number | Show N lines after each match (-A) | | before_context | number | Show N lines before each match (-B) | | context | number | Show N lines before and after each match (-C) |

Use pscribe_grep for queries like "did anyone mention deployment last week?" or "find all references to the API".

Output Format: TOON

The server returns transcript data in TOON format, a token-efficient format designed for LLM consumption:

transcript{timestamp,source,status,segment,confidence,duration,language,text}:
  2024-01-15T14:30:00+01:00,M,C,1,0.95,2.5,en,Hello world
  2024-01-15T14:30:05+01:00,S,C,2,0.92,3.1,sv,Hej dar

Fields

| Field | Description | |-------|-------------| | timestamp | ISO8601 with timezone | | source | M (microphone), S (system audio), E (events) | | status | C (confirmed), U (unconfirmed), T (translated), N (no_speech) | | segment | Incrementing segment number | | confidence | Whisper confidence score (0.0-1.0) | | duration | Segment duration in seconds | | language | ISO 639-1 code (e.g., en, sv, de) | | text | Transcribed content |

Polling Strategy

For real-time monitoring, agents should:

Call pscribe_status to ensure a session is active
Call pscribe_tail with n: 10 to get initial context
Note the last_line number from the response metadata
Periodically call pscribe_tail with since_line: last_line + 1
Use status: "confirmed" to focus on finalized transcriptions

Example Prompts

See the examples/ directory for ready-to-use prompts:

standup.md: Daily standup meeting assistant
retro.md: Sprint retrospective facilitator
code-review.md: Code review meeting tracker
pair-programming.md: Pair programming session monitor
adr.md: Architecture Decision Record generator

Security & Privacy

Local-Only: Data flows exclusively from the local pscribe CLI to the local AI agent via stdio
Zero-Cloud: No analytics, no telemetry, no intermediate servers
User Control: You decide when transcription is active and which AI agent receives the data

Development

# Install dependencies
npm install

# Development mode (auto-reload)
npm run dev

# Build
npm run build

# Test with MCP inspector
npm run inspect

License

MIT

ParrotScribe MCP Server