Listen MCP server

<!-- markdownlint-disable MD033 MD041 -->

mcp-listen

Give your AI agents the ability to listen

Microphone capture and speech-to-text tools for MCP-compatible agents.

<!-- badges: start --> Meta &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <!-- badges: end -->

Tools

Quick Start

Claude Code

claude mcp add mcp-listen npx mcp-listen

Claude Desktop / ChatGPT Desktop / Cursor / Windsurf / VS Code

Add to your MCP configuration:

{
  "mcpServers": {
    "mcp-listen": {
      "command": "npx",
      "args": ["-y", "mcp-listen"]
    }
  }
}

Compatible with Claude Desktop, ChatGPT Desktop, Cursor, GitHub Copilot, Windsurf, VS Code, Gemini, Zed, and any MCP-compatible client.

Global Install

npm install -g mcp-listen

Requirements

Supported platforms:

• Windows x64
• macOS Apple silicon (arm64)
• Linux x64 and arm64 (glibc)

Intel Mac (darwin-x64) is not supported: Apple has discontinued the platform and no decibri binary is published for it.

For listaudiodevices and captureaudio:**

• Node.js 18+
• A microphone

For voicequery (optional):**

• Ollama running locally
• Whisper GGML model (see Whisper Model Setup)

Tool Reference

Arguments are validated before anything is recorded or written. An argument a tool does not declare is rejected with an error naming it, rather than silently ignored. durationms must be an integer between 100 and 30000; silencems an integer between 100 and 10000; stoponsilence a boolean; device a non-negative integer index or a non-empty string id from listaudiodevices. A silence_ms that cannot take effect (passed without silence-stopping active) is rejected for the same reason unknown arguments are. A rejected call writes nothing to disk.

listaudiodevices

Returns a JSON array of available audio input devices.

Parameters: None

Example response:

[
  { "index": 0, "name": "Microphone", "id": "wasapi:{0.0.1.00000000}.{6b187949-26ea-470b-907d-66bf87261530}", "maxInputChannels": 2, "defaultSampleRate": 48000, "isDefault": true },
  { "index": 1, "name": "Microphone Array", "id": "wasapi:{0.0.1.00000000}.{b7a6e3e2-a62b-4e92-9320-947c4be98552}", "maxInputChannels": 2, "defaultSampleRate": 48000, "isDefault": false }
]

Shortened. The full README is on GitHub.