Cursor Wakatime heartbeats
How to: Cursor Wakatime heartbeats
Add Wakatime to Cursor
-
01
Open ~/.cursor/mcp.json and merge this in. Keep any servers already there.
{
"mcpServers": {
"wakatime": {
"url": "https://gateway.pipeworx.io/wakatime/mcp"
}
}
}-
02
Save the file and restart Cursor.
-
03
Ask for something heartbeats does. Cursor lists the server's tools on connect and calls heartbeats itself — you do not invoke it by name.
-
04
If nothing happens, check the server is running and that Wakatime's identifier in your config matches the one above exactly.
Use .cursor/mcp.json in a project root instead to scope it to that project. Cursor merges both. Cursor docs
Set these first
Wakatime will not start until these are set, so heartbeats never becomes available.
-
PIPEWORX_API_KEY
Same tool, other clients
This list was read from the server itself, by connecting to it and calling tools/list on 14 November 2026. It is what
the server actually exposes, not what its listing claims.
Mutating and Read-only are read off each tool's name, not its schema — a hint, not a guarantee. The registry stores tool names only; connect the server for its live schemas.