Heard Friends

dev.heardv1.0.1更新于 Oct 6, 2026

Your coding agents' hours this month, your friends board, and invites you approve.

已验证Streamable HTTP可网页运行Productivity & WorkflowCommunication & Collaboration

概览

AI 生成的概览

让助手读取你每月的编码智能体工时、与好友排行榜对比，并发送邀请。

功能
这是一个托管型 MCP 服务器，面向 Heard——Mac 上为编码智能体提供语音播报的层。它提供工具来报告你本月的智能体工时和好友中的排名、生成可直接粘贴的分享文案（含工时与邀请链接）、与选择共享的好友进行排名对比，以及向一位好友发送邀请邮件。邀请工具首次调用只显示预览，需你确认后才会发送，每天最多五封。
适用场景
如果你在 Mac 上使用 Heard，并希望向助手询问每月智能体工时、查看自己在好友榜上的位置，或生成带邀请链接的分享文案，就值得添加。若不使用 Heard，或不愿把工时分享给好友，则用处不大。
运行要求
远程 streamable HTTP 端点 Heard 账号，以及从 heard.dev/connect 获取的 bearer 密钥，通过 Authorization 请求头提供（部分客户端可用 HEARD_KEY 环境变量）。需要网络访问。
安装前请注意
Authorization bearer 密钥属于机密；持有者可读取你的工时与邀请链接并发送邀请，因此不要写入共享配置，泄露后请在 heard.dev/connect 撤销。邀请工具会向好友发送真实邮件，但会先预览，且每天上限五封。服务器可见你的名字、每月智能体工时、排名和邀请链接；Heard 声明不会读取提示词或代码。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Heard Friends，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "friends": {
      "type": "http",
      "url": "https://api.heard.dev/v1/mcp/share"
    }
  }
}

README

[Heard]

Heard Friends MCP

Ask your AI assistant how many hours your coding agents worked this month.

Heard is the voice layer for coding agents on the Mac. It reads Claude Code and Codex out loud while they work. It also keeps one number per month: how long your agents were busy. This MCP server lets Claude, ChatGPT, Codex, Cursor and other assistants read that number, show your board next to your friends, and send an invite when you ask for one.

It's a hosted server. There's nothing to install or run.

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

Things to ask

  • "How many hours did my coding agents work this month?"
  • "Where am I on my Heard board?"
  • "Write a short post about my month with my invite link."
  • "Invite [email protected] to Heard."

Tools

ToolWhat it doesChanges anything?
heard_my_monthYour agent hours this month and your rank among friendsNo
heard_share_cardA ready-to-paste line with your hours and invite linkNo
heard_compareYou and your friends, ranked by agent hoursNo
heard_invite_friendEmails one friend an invite. The first call only shows a preview. It sends after you say yes. Max 5 a day.Yes, sends one email

Set it up

  1. Sign in at heard.dev/connect and click Get my key. The page gives you the exact line for each app, key included.
  2. Paste it into your assistant.

Claude Code

bash
claude mcp add --transport http heard https://api.heard.dev/v1/mcp/share \  --header "Authorization: Bearer $HEARD_KEY"

Or as a plugin:

bash
claude plugin marketplace add heardlabs/heard-mcpclaude plugin install heard-friends@heard

The plugin reads your key from the HEARD_KEY environment variable.

Codex (~/.codex/config.toml)

toml
[mcp_servers.heard]url = "https://api.heard.dev/v1/mcp/share"bearer_token_env_var = "HEARD_KEY"

Cursor and other apps (mcp.json)

json
{  "mcpServers": {    "heard": {      "type": "http",      "url": "https://api.heard.dev/v1/mcp/share",      "headers": { "Authorization": "Bearer hgs_your_key" }    }  }}

Claude.ai, ChatGPT, Grok, Meta Muse: add a custom connector with the URL above and an Authorization: Bearer <key> header. One-click sign-in for these apps is coming. It won't need a key.

What the assistant can see

Your first name, your agent hours for the month, your rank on your board, and your invite link. That's it. Heard counts hours from the timestamps Claude Code and Codex save on your Mac. It never reads your prompts or your code, and none of that reaches this server. Friends only show up if they chose to share their hours.

Turn your key off any time at heard.dev/connect. Getting a new key also turns off the old one.

Privacy · Terms · Help · Docs

来源：friends/README.md，提交 c564dad

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v1.0.1最新Oct 6, 2026