Heads-up MCP
A local MCP server that provides spoken voice alerts on Mac, Linux, or Windows when Claude Code finishes a task or needs user attention, supporting built-in clips and custom TTS voices.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Notify user when coding task completes
- Request review via spoken alert
- Play voice alerts without API keys
Source and maintenance
Community listingRegistry 1.6.0
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
headsup-mcp 1.6.0
npm
headsup-mcp package definition
{
"version": "1.6.0",
"transport": "stdio",
"identifier": "headsup-mcp",
"registryType": "npm",
"packageArguments": [
{
"type": "positional",
"value": "serve"
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
Cursor configuration
{
"mcpServers": {
"heads-up-mcp": {
"command": "npx",
"args": [
"-y",
"headsup-mcp@1.6.0",
"serve"
]
}
}
}Cline
Cline configuration
{
"mcpServers": {
"heads-up-mcp": {
"command": "npx",
"args": [
"-y",
"headsup-mcp@1.6.0",
"serve"
]
}
}
}VS Code
VS Code configuration
{
"servers": {
"heads-up-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"headsup-mcp@1.6.0",
"serve"
]
}
}
}Claude Desktop
Claude Desktop configuration
{
"mcpServers": {
"heads-up-mcp": {
"command": "npx",
"args": [
"-y",
"headsup-mcp@1.6.0",
"serve"
]
}
}
}Let your agent find its tools
Find servers like Heads-up MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.