ParrotScribe MCP Server (Deprecated) & Lex Copilot

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

1. Ensure you are on Parrot Scribe < 0.4.0 and this MCP server is configured in your environment.

2. Copy agent/lex.md from this repository into your local .opencode/agent/ directory.

Related MCP server: @hyperwhisper/mcp

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)

Available Tools

pscribe_tail Parameters

pscribe_cat Parameters

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

pscribe_grep Parameters

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

Polling Strategy

For real-time monitoring, agents should:

1. Call pscribe_status to ensure a session is active

2. Call pscribe_tail with n: 10 to get initial context

3. Note the last_line number from the response metadata

4. Periodically call pscribe_tail with since_line: last_line + 1

5. 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

Links

• ParrotScribe App

• Model Context Protocol

• TOON Format