# Earshot Relay

> Earshot Relay is an MCP server for developer tools. Send speech from any agent or script to your Android phone via S3. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** Android, Self-hosted, API, CLI
- **Website:** https://store.automaticai.io/earshot/
- **Repository:** https://github.com/automaticai-io/earshot-relay
- **MCP Registry name:** io.github.AutomaticAI-io/earshot-relay
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-22

## About

Earshot Relay is a small self-hosted service that lets scripts, CI jobs and AI agents speak on your phone. You post text or an audio file to the relay, it drops an object into your own S3-compatible bucket, and the Earshot Android app plays it aloud, with no tap, through whatever output is active.

Normal messages are held while a call is active and are never played late: anything older than the age limit, 30 minutes by default, is marked missed. Each message records what the phone did, and receipts can be sent to your own server. An alarm channel plays on the alarm stream for what you decide is urgent. Messages never pass through the vendor's servers.

The relay runs as a Docker image with a CLI and an MCP server, and the Android app is a paid beta after a 30-day trial.

## Features

- **Speech to your phone:** Text or audio files dropped in your bucket play on the phone automatically.
- **Call-aware playback:** Messages wait until a call ends and play from the start.
- **Freshness limit:** Stale messages are marked missed instead of being read late.
- **Playback receipts:** See whether the phone detected, started, finished, failed or missed each message.
- **Alarm channel:** Files in alarm/ play loudly on the alarm stream.
- **Your own storage:** Uses any S3-compatible bucket, tested with Cloudflare R2 and MinIO.

## Good for

- Hear a coding agent announce a finished build
- Get CI failures read out in the car
- Have Home Assistant or n8n speak alerts
- Check receipts to confirm the phone played a message

## Install

### Claude Code (Terminal)

```sh
claude mcp add earshot-relay -- docker run -i --rm ghcr.io/automaticai-io/earshot-relay:1.1.2
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "earshot-relay": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/automaticai-io/earshot-relay:1.1.2"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "earshot-relay": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/automaticai-io/earshot-relay:1.1.2"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "earshot-relay": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/automaticai-io/earshot-relay:1.1.2"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "earshot-relay": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/automaticai-io/earshot-relay:1.1.2"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "earshot-relay": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/automaticai-io/earshot-relay:1.1.2"
      ]
    }
  }
}
```

## FAQ

### Which phones are supported?

Android 8.0 or newer. There is no iPhone version.

### How much does the app cost?

$4.99 once after a 30-day free trial, with no subscription.

### Do messages pass through the vendor's servers?

No. They go from your bucket to your phone.

### How do I run the relay?

As the ghcr.io/automaticai-io/earshot-relay Docker image, on amd64 or arm64.

### How do I add Earshot Relay to Claude Code?

Run this command in your terminal: claude mcp add earshot-relay -- docker run -i --rm ghcr.io/automaticai-io/earshot-relay:1.1.2

### What are the best alternatives to Earshot Relay?

The closest alternatives to Earshot Relay are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/earshot-relay
