Skip to content

[FEATURE]: Voice input MCP server for CLI terminal tools #41413

Closed as not planned

Description

@YuvrajSinghBhadoria2

Feature request

  • I have searched for existing issues and confirmed this is not a duplicate

Problem

Terminal-based AI coding tools (OpenCode CLI, Claude Code, Cursor) cannot use voice input because terminal apps do not support clickable microphone icons. Users must type all prompts manually.

Proposed Solution

Add voice input support via a standalone MCP server (@opencode-ai/voice-mcp) that provides:

  1. voice_transcribe — Record audio from microphone and transcribe to text
  2. voice_type — Record, transcribe, and type at cursor position
  3. voice_status — Check voice input availability

Implementation

  • MCP server using @modelcontextprotocol/sdk
  • Local Whisper transcription via faster-whisper (Python)
  • Cross-platform recording (sox/ffmpeg)
  • 100% local — no cloud API required
  • Works with OpenCode CLI, Claude Code, Cursor, and any MCP-compatible tool

Usage

Users add to their config:

{
  "mcpServers": {
    "voice": {
      "command": "npx",
      "args": ["-y", "@opencode-ai/voice-mcp"]
    }
  }
}

Differentiation from existing issues

Existing issues (#41364, #33300, #35219, #37742, #39688) focus on desktop app voice input (GUI microphone button). This issue is about CLI/terminal voice input via MCP server, which works across all MCP-compatible tools.

Benefits

  • Works in any terminal app (not just desktop)
  • No subscription required
  • 100% local processing
  • Simple one-line config
  • Cross-platform (macOS, Linux, Windows)

Testing

  • Tested on macOS with faster-whisper base model
  • Recording works with sox
  • MCP server verified with tool listing

Next Steps

  1. Review this issue
  2. If approved, submit PR with implementation
  3. Publish to npm as @opencode-ai/voice-mcp

Activity

  1. github-actions commented on Aug 9, 2026

    @github-actions
    Contributor

    This issue does not fully meet our contributing guidelines.

    What needs to be fixed:

    • Feature requests must use the **[FEATURE]: ** prefix in the title (e.g. [FEATURE]: Add voice input support via MCP server)
    • The feature request template requires a verification checkbox confirming you have searched for existing issues — this was not included

    Please edit this issue to address the above within 2 hours, or it will be automatically closed.


    This issue might be a duplicate of existing issues. Please check:

    If you believe this was flagged incorrectly, please let a maintainer know.

  2. changed the title [-]feat: Add voice input support via MCP server[/-] [+][FEATURE]: Voice input MCP server for CLI terminal tools[/+] on Aug 9, 2026
  3. github-actions commented on Aug 9, 2026

    @github-actions
    Contributor

    Thanks for updating the issue! It now meets the contributing guidelines. We appreciate the detailed write-up and the effort to differentiate this from existing voice input requests.

  4. YuvrajSinghBhadoria2 commented on Aug 15, 2026

    @YuvrajSinghBhadoria2
    Author

    Update: implementation published 🎤

    The voice MCP server is built and published to npm. Note: it's published under my own scope (@yuvarjbhado) since I don't own the @opencode-ai org on npm — the install snippet in the original post should use this name:

    {
      "mcpServers": {
        "voice": {
          "command": "npx",
          "args": ["-y", "@yuvarjbhado/voice-mcp"]
        }
      }
    }

    Or with OpenCode's mcp key:

    {
      "mcp": {
        "voice": {
          "command": "npx",
          "args": ["-y", "@yuvarjbhado/voice-mcp"]
        }
      }
    }

    What it provides:

    • voice_transcribe — record + local Whisper transcription
    • voice_type — record, transcribe, and type at cursor
    • voice_status — check availability

    100% local (faster-whisper), cross-platform (sox/ffmpeg), no cloud API. Source: https://github.com/YuvrajSinghBhadoria2/opencode-voice-mcp

    Still happy to fold this into the opencode repo (docs or a packages/ dir) if maintainers want it core — just let me know the preferred location.

  5. x-lixu commented on Aug 18, 2026

    @x-lixu

    Nice work shipping the dictation MCP — push-to-talk transcription is a solid baseline for terminal tools.

    Worth noting there's a complementary approach if you want conversation rather than dictation: qwen-audio-agent (disclosure: I maintain it) runs a full-duplex voice frontend in front of CLI agents including OpenCode:

    • No push-to-talk: talk while the agent works, interrupt mid-task (barge-in)
    • Spoken results: long-running task outcomes are announced back by voice, so you can step away from the terminal
    • Voice permission gates: destructive tool calls require spoken confirmation
    • Local wake word (sherpa-onnx, on-device)

    OpenCode is a first-class backend — qwenaudio install opencode sets it up, then qwenaudio --backend opencode (or the desktop orb) starts a voice session over ACP.

    The two aren't mutually exclusive: a dictation MCP covers "type by voice" inside the TUI, while a runtime like this covers "supervise the agent hands-free".

  6. YuvrajSinghBhadoria2 commented on Sep 6, 2026

    @YuvrajSinghBhadoria2
    Author

    @jlongster — wanted to check in on this one since it's been quiet for a few weeks. The voice MCP server is live and published (@yuvarjbhado/voice-mcp, 100% local faster-whisper). The earlier docs PR (#42769) was raised as official-docs placement, but I'd rather match what maintainers actually want than push a personal package into the Guides. Two options:

    1. Keep voice input core/documented inside opencode (docs + optionally a packages/ integration), or
    2. List it in the ecosystem listing instead.

    Happy to fold the guide into whichever home you prefer — or close this out cleanly if core voice input isn't on the roadmap. Thanks!

  7. neriousy commented on Oct 20, 2026

    @neriousy
    Member

    Thanks for building and publishing this voice MCP server. We're closing the proposal to include it in OpenCode.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions