# agentring

agentring — an MCP server for Claude Code connects AI agents to an Android phone for text messages and phone calls. Brings user replies and audio transcripts back into the active agent session.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 459 repo stars
- Author: mutonby
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mutonby/agentring/tree/HEAD/daemon
- Updated: 2026-11-12
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/agentring

## What it does

The server exposes tools for communicating with an Android device. The assistant can send text notifications, trigger phone calls, and capture transcripts or text replies into the workflow.

Running the tool requires a self-hosted relay deployed via Docker compose and the companion Android app. Voice features require setting `GEMINI_API_KEY` inside `~/.agentring/.env`.

Plain HTTP relays are rejected unless pointing to loopback, private networks, or Tailscale CGNAT addresses. Setting `AGENTRING_ALLOW_INSECURE_RELAY=1` overrides this restriction on trusted networks.

## Requirements
- Needs: Docker
- Remote server: `https://agentring.io/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http daemon https://agentring.io/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add daemon --url https://agentring.io/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "daemon": {
            "url": "https://agentring.io/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "daemon": {
            "type": "http",
            "url": "https://agentring.io/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http daemon https://agentring.io/mcp
```

## When to use it
- send text updates to an Android phone
- request user confirmation via an automated voice call
- pull call transcripts into the coding context
- route agent alerts through a private self-hosted relay

## Example prompts
- Call my phone and ask for confirmation to deploy to production
- Send a message via agentring when the build finishes

## Similar
- [call-me](https://affpapa.org/en/nevibecode/plugins/call-me.md) — plugin · ★ 1596 repo stars
- [phone_event](https://affpapa.org/en/nevibecode/prompts/phone-event.md) — prompt · ★ 9488 repo stars
- [Heard](https://affpapa.org/en/nevibecode/mcp/heard.md) — MCP server
- [openclaw-relay](https://affpapa.org/en/nevibecode/skills/openclaw-relay.md) — skill · 120 installs
- [LFG Alarm](https://affpapa.org/en/nevibecode/mcp/lfg-alarm.md) — MCP server · ★ 11 repo stars
- [voice-to-report](https://affpapa.org/en/nevibecode/skills/voice-to-report.md) — skill · 115 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
