# Heard

Cloud agents report progress out loud through the Heard Mac app, and you reply by voice.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: heardlabs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/heardlabs/heard-mcp
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/heard

## What it does

The server connects cloud-based agents to the Heard app on your Mac. Agents send short updates with `heard_report` — working, done, needs input, failed — and Heard reads them aloud, named after the agent. You can reply by holding right ⌘, saying the agent's name and your message; the agent retrieves it via `heard_inbox` and confirms pickup with `heard_inbox_ack`.

It's a hosted server at `https://api.heard.dev/v1/mcp/agent`. Nothing to install on the agent side. Connection works via OAuth (Claude, ChatGPT, Grok Bot, Codex) or token (Meta Muse, Devin, Manus, GitHub Copilot). Requires the Heard app for macOS with an active account; voice replies require a Heard Power subscription. Updates stay for a week, voice inbox messages get removed after a month if the agent doesn't retrieve them.

## Requirements
- Remote server: `https://api.heard.dev/v1/mcp/agent`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http heard https://api.heard.dev/v1/mcp/agent
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add heard --url https://api.heard.dev/v1/mcp/agent
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "heard": {
            "url": "https://api.heard.dev/v1/mcp/agent"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "heard": {
            "type": "http",
            "url": "https://api.heard.dev/v1/mcp/agent"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http heard https://api.heard.dev/v1/mcp/agent
```

## When to use it
- hear progress updates from cloud agents on your Mac
- reply to agent questions by voice without switching context
- get notified when an agent waits for your decision
- coordinate multiple agents from one app

## Example prompts
- Report your progress out loud through Heard when deployment finishes
- Check my Heard inbox for new instructions and continue
- Mark my last message as picked up

## Similar
- [agent-ping](https://affpapa.org/en/nevibecode/plugins/agent-ping.md) — plugin · ★ 6
- [Twilio SMS Automation](https://affpapa.org/en/nevibecode/skills/twilio-sms-automation.md) — skill · 5400 installs
- [sag](https://affpapa.org/en/nevibecode/skills/sag.md) — skill · 5200 installs
- [M1K3](https://affpapa.org/en/nevibecode/mcp/m1k3.md) — MCP server · ★ 6
- [gws-chat-send](https://affpapa.org/en/nevibecode/skills/gws-chat-send.md) — skill · 32000 installs
- [call4me](https://affpapa.org/en/nevibecode/mcp/call4me.md) — MCP server · ★ 16

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