Heard — Claude Code MCP server: what it does, how to install
Cloud agents report progress out loud through the Heard Mac app, and you reply by voice.
claude mcp add --transport http heard https://api.heard.dev/v1/mcp/agentWhat Heard 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.
What it helps with
- 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 for the agent
- 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
How to install Heard
Platform CLI: remote server
claude mcp add --transport http heard https://api.heard.dev/v1/mcp/agentPlatform CLI: remote server
codex mcp add heard --url https://api.heard.dev/v1/mcp/agentConfig file
{
"mcpServers": {
"heard": {
"url": "https://api.heard.dev/v1/mcp/agent"
}
}
}Config file
{
"servers": {
"heard": {
"type": "http",
"url": "https://api.heard.dev/v1/mcp/agent"
}
}
}Platform CLI: remote server
gemini mcp add -t http heard https://api.heard.dev/v1/mcp/agentStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Heard
How to install Heard in Claude Code?
Run claude mcp add --transport http heard https://api.heard.dev/v1/mcp/agent, then sign in to your Heard account through the Mac app.
What does Heard do?
The server delivers short agent updates to your Mac by voice and sends your spoken commands back to the agent. The agent calls the report tool, Heard reads the message aloud, you reply by voice, the agent picks up the reply from its inbox.
Does Heard require a subscription?
Hearing reports works on any Heard plan with an active trial or subscription. Voice replies require a Heard Power subscription.
