EarSay MCP

MCP server for EarSay — continuous voice-to-text for coding agents.

Connects to a running EarSay transcription server and exposes voice input as MCP tools that any MCP-compatible agent (OpenCode, Claude, etc.) can use.

Features

• Start/stop/pause/resume — full control over the transcription server

• Poll for new text — call voice_get_new to check what the user said since last time

• Checkpoints — mark what you've already read so you only get new content

• Status — check if the server is listening, paused, or stopped

Installation

pip install earsay-mcp

Requires EarSay to be installed separately.

Usage

With OpenCode

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

{
  "mcpServers": {
    "earsay": {
      "command": "earsay-mcp"
    }
  }
}

The agent will see these tools:

With Claude Desktop

{
  "mcpServers": {
    "earsay": {
      "command": "earsay-mcp"
    }
  }
}

How It Works

Microphone → EarSay (faster-whisper) → HTTP API (localhost:3009)
                                              ↑
                                         earsay-mcp (stdio JSON-RPC)
                                              ↑
                                         OpenCode Agent (MCP client)

The MCP server starts EarSay as a subprocess on first voice_start call, then translates all MCP tool calls into HTTP requests to EarSay's API.

Requirements

• Python 3.10+

• EarSay installed (pip install earsay)

• Working microphone

License

MIT