STT MCP Server Linux
Local speech-to-text MCP server for Tmux on Linux (for use not only with Claude Code)
What is STT MCP Server Linux?
STT MCP Server Linux is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to local speech-to-text mcp server for tmux on linux (for use not only with claude code)
Local speech-to-text MCP server for Tmux on Linux (for use not only with Claude Code)
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Local speech-to-text MCP server for Tmux on Linux (for use n
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx stt-mcp-server-linuxConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use STT MCP Server Linux
STT MCP Server Linux is a local speech-to-text MCP server for Linux that runs inside a Docker container and exposes a `transcribe` tool via the Model Context Protocol. It uses OpenAI Whisper (tiny model by default) to transcribe microphone audio captured with a push-to-talk mechanism triggered by the Right Ctrl key. The transcribed text is injected directly into a Tmux session's input buffer, making it ideal for hands-free voice input into Claude Code without sending any audio to cloud services. It also supports a standalone mode independent of MCP for use with any shell session.
Prerequisites
- Linux operating system (required for /dev/input and /dev/snd device access)
- Docker Engine or Docker Desktop installed and running
- Tmux installed (the server injects transcribed text via tmux send-keys)
- Claude Code installed and configured as the MCP client
- Claude Code must be run inside a Tmux session
Clone the repository
Clone the stt-mcp-server-linux repository and set the path variable for use in later steps.
git clone https://github.com/marcindulak/stt-mcp-server-linux
cd stt-mcp-server-linux
export STT_MCP_SERVER_LINUX_PATH=$(pwd)Build the Docker image
Build the Docker container image that includes the speech-to-text runtime with Whisper and all audio processing dependencies.
bash scripts/build_docker_image.shDownload the Whisper model
Download the Whisper tiny model to ~/.stt-mcp-server-linux/whisper. This model runs entirely locally and does not send audio to any external service.
bash scripts/download_whisper_model.shConfigure Tmux
Add the required Tmux settings to ~/.tmux.conf. These settings enable mouse support, increase the scrollback buffer, hide the status bar to reduce flicker, and reduce the escape-key delay.
cat >> ~/.tmux.conf <<'EOF'
set -g mouse on
set -g history-limit 1000000
set -g status off
set -g escape-time 0
EOFRegister the MCP server with Claude Code
Run the provided helper script from your project directory to add the server to Claude Code with user-level scope. Verify the connection with `claude mcp list`.
bash "${STT_MCP_SERVER_LINUX_PATH}/scripts/add_mcp_server_to_claude.sh"
claude mcp listStart Claude Code inside a Tmux session
Launch Claude inside a Tmux session using a custom TMUX_TMPDIR that is shared between the Docker host and the container. Then ask Claude to activate the transcribe tool.
TMUX_TMPDIR=~/.stt-mcp-server-linux/tmux tmux new-session -s claude 'claude'Activate push-to-talk
Inside the Claude Code session, ask Claude to run the transcribe tool provided by stt-mcp-server-linux. Once the server logs 'Waiting for Right Ctrl key press', hold Right Ctrl to record and release to transcribe. Use `docker logs stt-mcp-server-linux` to monitor startup progress.
STT MCP Server Linux Examples
Client configuration
The add_mcp_server_to_claude.sh script registers the server automatically. The equivalent manual Claude Code CLI command to add it is shown below.
{
"mcpServers": {
"stt-mcp-server-linux": {
"command": "bash",
"args": ["/path/to/stt-mcp-server-linux/scripts/restart_mcp_server.sh"]
}
}
}Prompts to try
Once the MCP server is active and listening, use these prompts inside the Claude Code Tmux session.
- "Run the transcribe tool provided by the stt-mcp-server-linux MCP server"
- "Check the status of the stt-mcp-server-linux MCP server with /mcp"
- "Stop transcription and quit" (press Right Ctrl to record, release to transcribe any voice prompt)Troubleshooting STT MCP Server Linux
The transcribe tool is not ready immediately after Claude Code starts
Give the Docker container time to initialize. Run `docker logs stt-mcp-server-linux` and wait for a log line containing 'Waiting for Right Ctrl key press on ... keyboard'. You can also run `/mcp` inside Claude Code to verify the server status.
Starting a second container stops the previous one
Only one transcription container can run at a time. If you start a new Tmux session or restart the service, the previous container is automatically replaced. This is by design — stop the first session before starting another.
Right Ctrl key is not detected
The server reads from /dev/input keyboard devices. Ensure the Docker container is granted access to host input devices (handled by the build/start scripts). If you use a custom keyboard layout or USB hub, check that /dev/input/event* devices for your keyboard are accessible inside the container.
Frequently Asked Questions about STT MCP Server Linux
What is STT MCP Server Linux?
STT MCP Server Linux is a Model Context Protocol (MCP) server that local speech-to-text mcp server for tmux on linux (for use not only with claude code) It connects AI assistants to external tools and data sources through a standardized interface.
How do I install STT MCP Server Linux?
Follow the installation instructions on the STT MCP Server Linux GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with STT MCP Server Linux?
STT MCP Server Linux works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is STT MCP Server Linux free to use?
Yes, STT MCP Server Linux is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
STT MCP Server Linux Alternatives — Similar Developer Tools Servers
Looking for alternatives to STT MCP Server Linux? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up STT MCP Server Linux in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use STT MCP Server Linux?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.