Speak your prompts. No typing required.
Installation β’ Quick Start β’ Tools β’ Configuration β’ Architecture β’ Contributing
| Feature | Description |
|---|---|
| π€ Voice Recording | Record audio from microphone with configurable duration |
| π£οΈ Speech-to-Text | Transcribe using local Whisper model (100% offline) |
| β¨οΈ Auto-Typing | Type transcribed text at cursor position |
| π Privacy First | No cloud API β audio never leaves your machine |
| π Multi-Language | Support for 99+ languages via Whisper |
| π MCP Standard | Works with OpenCode, Claude Code, Cursor, and more |
# Install globally
npm install -g @yuvarjbhado/voice-mcp
# Or use with npx (no install required)
npx @yuvarjbhado/voice-mcpmacOS
# Install recording tool
brew install sox
# Install transcription engine
pip install faster-whisperLinux (Ubuntu/Debian)
# Install recording tool
sudo apt install sox
# Install transcription engine
pip install faster-whisperWindows
# Install FFmpeg (via scoop)
scoop install ffmpeg
# Install transcription engine
pip install faster-whisperAdd to your MCP config file:
| Tool | Config Location |
|---|---|
| OpenCode | ~/.config/opencode/config.json |
| Claude Code | ~/.claude/claude_desktop_config.json |
| Cursor | ~/.cursor/mcp.json |
OpenCode (use mcp key):
{
"mcp": {
"voice": {
"command": "npx",
"args": ["-y", "@yuvarjbhado/voice-mcp"]
}
}
}Claude Desktop / Cursor (use mcpServers key):
{
"mcpServers": {
"voice": {
"command": "npx",
"args": ["-y", "@yuvarjbhado/voice-mcp"]
}
}
}Restart OpenCode, Claude Code, or Cursor to load the MCP server.
@voice voice_transcribe
@voice voice_type
@voice voice_status
Record audio from microphone and transcribe to text.
{
"name": "voice_transcribe",
"arguments": {
"duration": 10,
"language": "en"
}
}| Parameter | Type | Default | Description |
|---|---|---|---|
duration |
number | 10 |
Recording duration in seconds |
language |
string | auto |
Language code (e.g., en, es, fr) |
Returns: Transcribed text as string.
Record audio, transcribe to text, and type it at the cursor position.
{
"name": "voice_type",
"arguments": {
"duration": 10,
"language": "en"
}
}| Parameter | Type | Default | Description |
|---|---|---|---|
duration |
number | 10 |
Recording duration in seconds |
language |
string | auto |
Language code |
Returns: Confirmation message with typed text.
Check if voice recording and transcription are available.
{
"name": "voice_status",
"arguments": {}
}Returns:
{
"recording": "rec",
"transcription": "faster-whisper (local)",
"platform": "darwin",
"ready": true
}| Variable | Description | Default |
|---|---|---|
WHISPER_MODEL |
Whisper model size | base |
WHISPER_DEVICE |
Device to use (cpu, cuda, auto) |
auto |
WHISPER_COMPUTE |
Compute type (int8, float16, float32) |
int8 |
| Model | Size | Speed | Accuracy | VRAM |
|---|---|---|---|---|
tiny |
~75MB | β‘β‘β‘β‘ | ββ | ~1GB |
base |
~150MB | β‘β‘β‘ | βββ | ~1GB |
small |
~500MB | β‘β‘ | ββββ | ~2GB |
medium |
~1.5GB | β‘ | βββββ | ~5GB |
large-v3 |
~3GB | π | βββββ | ~10GB |
Recommendation: Use base for best balance of speed and accuracy.
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β MCP Client β
β (OpenCode / Claude Code / Cursor) β
ββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββ
β JSON-RPC
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Voice MCP Server β
β (Node.js) β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β ββββββββββββββββ ββββββββββββββββ ββββββββββββββββ β
β β voice_record β βvoice_transcribeβ β voice_type β β
β β Tool β β Tool β β Tool β β
β ββββββββ¬ββββββββ ββββββββ¬ββββββββ ββββββββ¬ββββββββ β
β β β β β
β βΌ βΌ βΌ β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β Audio Recording Layer β β
β β (sox / ffmpeg / macOS rec) β β
β βββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββ β
β β β
β βΌ β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β Transcription Engine β β
β β (faster-whisper / OpenAI API) β β
β βββββββββββββββββββββββββββ¬ββββββββββββββββββββββββββββ β
β β β
β βΌ β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
β β Output Layer β β
β β βββββββββββββββ βββββββββββββββββββββββ β β
β β β Return Text β β Type at Cursor β β β
β β β (MCP) β β (osascript/xdotool) β β β
β β βββββββββββββββ βββββββββββββββββββββββ β β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββ β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
βββββββββββ βββββββββββ βββββββββββββββ βββββββββββ
β User βββββΆβ Micro- βββββΆβ Whisper βββββΆβ Text β
β Speaks β β phone β β Transcribe β β Output β
βββββββββββ βββββββββββ βββββββββββββββ βββββββββββ
β β β β
β β β β
βΌ βΌ βΌ βΌ
"Hello Records 16kHz Processes with Returns text
world" mono audio base model or types it
# Clone repository
git clone https://github.com/YuvrajSinghBhadoria2/opencode-voice-mcp.git
cd opencode-voice-mcp
# Install dependencies
npm install
# Build
npm run build
# Run in development
npm run devopencode-voice-mcp/
βββ src/
β βββ index.ts # MCP server implementation
βββ dist/
β βββ index.js # Compiled output
βββ package.json # Package configuration
βββ tsconfig.json # TypeScript config
βββ build.sh # Build script
βββ publish.sh # npm publish script
| Command | Description |
|---|---|
npm run build |
Compile TypeScript to JavaScript |
npm run dev |
Run in development mode with tsx |
npm run start |
Run compiled server |
./publish.sh |
Build and publish to npm |
Contributions are welcome! Please follow these steps:
- Fork the repository
- Create a feature branch (
git checkout -b feat/amazing-feature) - Commit your changes (
git commit -m 'feat: add amazing feature') - Push to the branch (
git push origin feat/amazing-feature) - Open a Pull Request
- Follow TypeScript best practices
- Add tests for new features
- Update documentation as needed
- Use conventional commit messages
This project is licensed under the MIT License - see the LICENSE file for details.
- Model Context Protocol - Standard for AI tool integration
- faster-whisper - Fast Whisper implementation
- OpenCode - AI coding assistant
- OpenAI Whisper - Speech recognition model
Built with β€οΈ for the developer community
Report Bug β’ Request Feature β’ Discussions