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

Tool	Description
start_listening()	Begin speech recognition
stop_listening()	Stop speech recognition
read_speech()	Get transcribed text
speak(text)	Text-to-speech response
heartbeat()	Keep the loop alive
get_status()	Check system status

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."