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