Heard Friends — Claude Code MCP server: what it does, how to install
Connects your assistant to your monthly agent work hours, friends leaderboard, and invite sharing without running a local process.
claude mcp add --transport http friends https://api.heard.dev/v1/mcp/shareWhat Heard Friends does
This is a hosted MCP server reachable at https://api.heard.dev/v1/mcp/share, removing any need to compile or run local background processes. It accesses stats collected by the Heard macOS companion, which monitors Claude Code and Codex execution timestamps. Assistants can query this data directly to report total monthly hours.
Four tools handle the integration. The heard_my_month tool reports your logged hours and current rank, heard_compare pulls the friends leaderboard, and heard_share_card prepares a short snippet with your referral URL. When adding colleagues, heard_invite_friend sends an invitation email. It enforces a cap of five per day, shows a preview first, and waits for your confirmation before sending.
Queries will fail without a key from heard.dev/connect. Supply it through the HEARD_KEY environment variable or an Authorization header. Your source files and prompt transcripts never leave your machine; the remote endpoint only handles your first name, calculated hours, leaderboard spot, and invite link.
What it helps with
- check total hours coding agents logged this month
- compare agent active time on a friends leaderboard
- generate a status snippet with your referral link
- send email invitations with an upfront preview
Example prompts for the agent
- Show where I rank on my Heard board compared to friends
- Invite [email protected] to Heard
How to install Heard Friends
Platform CLI: remote server
claude mcp add --transport http friends https://api.heard.dev/v1/mcp/sharePlatform CLI: remote server
codex mcp add friends --url https://api.heard.dev/v1/mcp/shareConfig file
{
"mcpServers": {
"friends": {
"url": "https://api.heard.dev/v1/mcp/share"
}
}
}Config file
{
"servers": {
"friends": {
"type": "http",
"url": "https://api.heard.dev/v1/mcp/share"
}
}
}Platform CLI: remote server
gemini mcp add -t http friends https://api.heard.dev/v1/mcp/shareStep 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 Friends
How do I install Heard Friends in Claude Code?
Run claude mcp add --transport http friends https://api.heard.dev/v1/mcp/share in your terminal. You will also need an authorization key generated at heard.dev/connect.
What does Heard Friends do?
It lets your assistant query the hosted Heard API to check monthly coding agent hours, display leaderboards among friends, and manage referral invitations.
Does the server access project code or prompts?
No, prompts and source code are never transmitted. The server only receives your first name, monthly hours, board position, and referral URL.
