README

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:

Tool	Description
`voice_start`	Start the transcription server
`voice_stop`	Stop the server
`voice_pause`	Pause transcription
`voice_resume`	Resume transcription
`voice_get_text`	Get all transcribed text
`voice_get_new`	Get text since last checkpoint
`voice_set_checkpoint`	Mark text as read
`voice_status`	Server status

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

EarSay MCP

README

EarSay MCP

Features

Installation

Usage

With OpenCode

With Claude Desktop

How It Works

Requirements

License

Recommended Servers