Skip to main content
Glama

Reachy Mini MCP Server

MCP (Model Context Protocol) server for controlling Reachy Mini robot from Claude.

Installation

uv sync

Related MCP server: Reachy Mini MCP

Usage

With Claude Code

Add to ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "reachy-mini": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/reachy-mini-mcp", "reachy-mini-mcp"],
      "env": {
        "REACHY_HOST": "localhost"
      }
    }
  }
}

Environment Variables

  • REACHY_HOST - Daemon host (default: localhost)

  • REACHY_PORT - Daemon port (default: 8000)

  • REACHY_SSH_USER - SSH username for streaming commands (default: reachy)

Available Tools

Tool

Description

reachy_status

Get daemon health status

reachy_get_state

Get full robot state

reachy_move_head

Move head (pitch, roll, yaw)

reachy_look_at

Look at world coordinates

reachy_move_body

Rotate body yaw

reachy_play_animation

Play animation (wave, nod, dance)

reachy_antenna_happy

Happy antenna expression

reachy_antenna_sad

Sad antenna expression

reachy_antenna_wiggle

Wiggle antennas

reachy_enable_motors

Enable motors (stiff)

reachy_disable_motors

Disable motors (limp)

reachy_gravity_compensation

Enable soft mode

reachy_capture_image

Capture camera frame

reachy_say

Text-to-speech

reachy_play_sound

Play sound file

reachy_start_webrtc_stream

Start WebRTC video/audio streaming

reachy_stop_webrtc_stream

Stop WebRTC streaming

reachy_webrtc_stream_status

Check if stream is running

Requirements

  • Reachy Mini daemon running on port 8000

  • Python 3.10+

Available Tools

19 tools
reachy_capture_imageA

Capture a single frame from the robot's camera

Inputs: no named parameters.

reachy_check_cameraA

Check if the robot's camera is working by capturing a test frame

Inputs: no named parameters.

reachy_check_microphoneA

Check if the robot's microphone is working by recording a short sample

Inputs: duration.

reachy_get_motor_statusB

Get detailed motor status information

Inputs: no named parameters.

reachy_get_stateA

Get full robot state including joint positions and sensor data

Inputs: no named parameters.

reachy_go_to_sleepA

Put the robot to sleep (execute sleep behavior)

Inputs: no named parameters.

reachy_go_to_zeroB

Move the robot to its zero/neutral position

Inputs: no named parameters.

reachy_list_audioA

List all saved audio recordings on the robot

Inputs: no named parameters.

reachy_move_antennasB

Move the robot's antennas to specified positions

Inputs: left, right, duration.

reachy_move_headB

Move the robot's head to a specific orientation. Pitch/roll limited to [-40, 40] degrees, yaw to [-180, 180] degrees.

Inputs: yaw, roll, pitch, duration.

reachy_play_audioA

Play an audio recording through the robot's speaker

Inputs: filename (required).

reachy_reconnectB

Try to reconnect to the robot daemon

Inputs: no named parameters.

reachy_start_continuous_moveB

Start continuous sinusoidal movement on the robot

Inputs: no named parameters.

reachy_start_webrtc_streamA

Start WebRTC video/audio streaming from the robot's camera and microphone. Returns the stream URL to connect to.

Inputs: no named parameters.

reachy_statusA

Get Reachy Mini daemon health status and robot connection info

Inputs: no named parameters.

reachy_stop_continuous_moveA

Stop continuous movement on the robot

Inputs: no named parameters.

reachy_stop_webrtc_streamA

Stop the WebRTC video/audio stream on the robot

Inputs: no named parameters.

reachy_wake_upB

Wake up the robot (execute wake up behavior)

Inputs: no named parameters.

reachy_webrtc_stream_statusA

Check if WebRTC stream is currently running and get the stream URL

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 19 tools

    Disambiguation4/5

    Most tools target clearly distinct actions such as moving the head, capturing images, or checking status. Some overlap exists among reachy_status, reachy_get_state, and reachy_get_motor_status, and between reachy_check_camera and reachy_capture_image, but the descriptions mostly clarify their different purposes.

    Naming Consistency5/5

    All tools follow a consistent reachy_ prefix with verb_noun naming, such as move_head, capture_image, and stop_webrtc_stream. The pattern is uniform and predictable across the entire set.

    Tool Count4/5

    At 19 tools, the count is slightly above the ideal sweet spot but remains justifiable for a robot control server covering movement, sensors, media, and streaming. The tools are not redundant enough to warrant trimming, though a few could potentially be consolidated.

    Completeness4/5

    The tool set covers the main robot lifecycle: wake/sleep, status, movement, camera, microphone, audio playback, and WebRTC streaming. Minor gaps exist such as no explicit individual joint control or audio file upload capability, but these do not critically undermine the server's apparent purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables robot navigation control and monitoring through natural language. Provides tools for robot positioning, navigation to coordinates, device status monitoring, task management, and emergency controls.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables control of Pollen Robotics Reachy Mini robot through high-level emotional expressions and low-level motor commands, with support for vision, audio, and text-to-speech capabilities.
      30
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables natural language control of Reachy Mini robots for tasks like head movement, camera capture, and performing choreographed dances or emotions. It includes local, low-latency text-to-speech capabilities with synchronized head animations for lifelike interaction.
      21
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Control a Reachy Mini robot through natural language, with tools for head/antenna movement, gestures, emotions, camera, and command sequences.
      35
      MIT