Progress Watch — Claude Code MCP server: features and setup
The Progress Watch MCP server for Claude Code sends task progress reports to a shared dashboard. Agents can post updates and mark long-running work as finished.
AGPL-3.0 updated 2026-11-15
Open on GitHubWhat Progress Watch does
Progress Watch collects task updates and displays them in a browser dashboard. An agent can report its current progress and signal completion; scripts can also send updates through the CLI or an HTTP request.
The server can run on your own infrastructure or use the hosted service. A space UUID acts as the credential for the hosted MCP endpoint. Data can be stored in SQLite or PostgreSQL; PostgreSQL uses the DATABASE_URL setting.
Completion alerts use Web Push. Docker and Docker Compose are available for self-hosting.
What it helps with
- track an agent's progress on a long task
- send script updates to a shared dashboard
- get notified when a task finishes
- show task steps and count-based progress
Example prompts for the agent
- Track this task and report when it is finished.
- Send progress updates for the migration to Progress Watch.
- Post the current task stage and signal completion.
How to install Progress Watch
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport http progresswatch https://progress.watch/mcp/{space_uuid}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
codex mcp add progress-watch --url https://progress.watch/mcp/{space_uuid}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"progress-watch": {
"url": "https://progress.watch/mcp/{space_uuid}"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"progress-watch": {
"type": "http",
"url": "https://progress.watch/mcp/{space_uuid}"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t http progress-watch https://progress.watch/mcp/{space_uuid}Step 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 Progress Watch
How do I install Progress Watch in Claude Code?
Run claude mcp add --transport http progresswatch https://progress.watch/mcp/{space_uuid}. Replace {space_uuid} with the space UUID.
What does Progress Watch do?
The MCP server receives task progress and completion reports, which appear on a browser dashboard. It can also send completion alerts through Web Push.
What does Progress Watch need to run?
Connecting to the hosted server requires a space UUID. For a self-hosted setup, choose SQLite or PostgreSQL; PostgreSQL uses DATABASE_URL.