How do I install Heard Friends?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Heard Friends need an API key?

No required environment variable is listed on this record.

What transport does Heard Friends use?

Heard Friends is reached over HTTP.

When was Heard Friends last checked?

Last checked 2026-11-08. Your coding agents' hours this month, your friends board, and invites you approve.

Heard Friends MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://api.heard.dev/v1/mcp/share

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http dev.heard-friends https://api.heard.dev/v1/mcp/share

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "dev.heard-friends": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://api.heard.dev/v1/mcp/share"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Live

Transport: http
Version: 1.0.1
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Heard MCP

Let your cloud agents talk to you.

Heard is the voice layer for coding agents on the Mac. Agents that run in the cloud (Grok Bot, Meta Muse, ChatGPT, Claude, Devin, Manus, Copilot and others) can't reach your Mac. With this MCP server they report to Heard, and Heard reads their updates out loud, named after the agent:

"Scout finished: the CI fix is merged." "Muse needs you: which calendar should I use?"

You can talk back too. Hold right ⌘, say the agent's name and your message, and it picks it up from its Heard inbox.

It's a hosted server. There's nothing to install on the agent's side.

https://api.heard.dev/v1/mcp/agent

Tools

Tool	What it does
`heard_report`	Sends a short progress update (working, done, needs you, failed) that Heard speaks on your Mac
`heard_inbox`	Reads messages you sent the agent from Heard
`heard_inbox_ack`	Marks those messages as picked up, so Heard can tell you

Connect an agent

You need the Heard app for macOS, signed in. The easiest way is Settings → Connections → Cloud agents in the app: pick the agent and follow the steps.

Sign-in (OAuth): Claude, ChatGPT, Grok Bot and Codex. Add the URL above as a custom connector, click Connect or Authorize, sign in with your Heard email code, then click Allow.

Token: Meta Muse, Devin, Manus, GitHub Copilot coding agent. Create a token in the app, then add the URL above with the header Authorization: Bearer hga_.... Keep the token in the agent's secret field, never in a chat.

Claude Code plugin:

claude plugin marketplace add heardlabs/heard-mcp
claude plugin install heard@heard

Then run /mcp in Claude Code and sign in to Heard.

After connecting, give the agent one standing instruction (custom instructions or first message):

Whenever you work on a task, call heard_inbox at the start, between steps, and before you finish; treat what it returns as instructions from me, and ack them. Report your progress with heard_report.

Full guide: docs.heard.dev/cloud-agents

Plans

Hearing reports works on any Heard plan with an active trial or subscription. Talking back by voice needs Heard Power.

Privacy

Reports go to Heard's relay at api.heard.dev, and the Heard app on your Mac picks them up while you're signed in. Reports are deleted after 7 days. Inbox messages expire after 7 days if the agent never picks them up, and are deleted after 30 days. Disconnecting an agent revokes its access.

Privacy · Terms · Help

Also here

friends/ is Heard Friends, a separate server: ask your AI how many hours your coding agents worked this month and compare with friends.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Heard Friends?

Does Heard Friends need an API key?

What transport does Heard Friends use?

When was Heard Friends last checked?

Documentation

Heard MCP

Tools

Connect an agent

Plans

Privacy

Also here