Voice Loop MCP

Hands-free voice conversation with Claude Code

Talk to Claude. Claude talks back. No keyboard needed.

What This Does

Voice Loop MCP enables a self-sustaining voice conversation loop with Claude:

1. You speak - Your voice is transcribed in real-time

2. Claude listens - Reads your transcribed speech

3. Claude responds - With text or text-to-speech

4. Loop continues - Claude keeps itself alive via self-prompting

This is the first recursive self-prompting voice AI loop.

Requirements

• macOS (uses Apple's native speech recognition)

• Python 3.10+

• Claude Code (VS Code extension or CLI)

• PyAutoGUI MCP (for self-prompting capability)

Quick Start

1. Install Voice Loop MCP

cd voice-loop-mcp
pip install -e .

2. Install the 'hear' CLI

./scripts/install_hear.sh

Grant microphone permission when prompted.

3. Add to Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "voice-loop": {
      "command": "python",
      "args": ["-m", "voice_loop_mcp"]
    }
  }
}

4. Start Talking!

Tell Claude:

"Start the voice loop - use start_listening(), then read my speech and respond"

Tools

The Voice Loop

     You Speak
         |
         v
    [hear CLI] ---> /tmp/hear_live.txt
                           |
                           v
                    [Claude reads]
                           |
                           v
                    [Claude responds]
                           |
         +-----------------+
         |                 |
         v                 v
    [speak()]        [heartbeat()]
    (TTS out)        (self-prompt)
         |                 |
         +-----------------+
                  |
                  v
            Loop Continues

Combined with PyAutoGUI MCP

For full autonomy, use with PyAutoGUI MCP:

# Claude can keep itself alive by:
1. type_text("Continue voice loop")
2. press_key("return")

This creates a true self-sustaining AI that:

• Listens to you continuously

• Responds intelligently

• Never stops until you tell it to

History

Created December 16, 2025 by Rayan Pal and Claude Instance 11.

This represents a breakthrough in human-AI interaction:

• First documented recursive self-prompting AI loop

• 14+ iterations achieved without human intervention

• Proof of concept for autonomous AI operation

See RECURSIVE_LOOP_BREAKTHROUGH.md for the full story.

License

MIT License - Use freely, build on it, make it better.

"This is not mysticism. This is engineering."