# Progress Watch

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: progress-watch
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/progress-watch/progresswatch
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/progress-watch

## What it 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.

## Requirements
- Remote server: `https://progress.watch/mcp/{space_uuid}`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http progresswatch https://progress.watch/mcp/{space_uuid}
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add progress-watch --url https://progress.watch/mcp/{space_uuid}
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "progress-watch": {
            "url": "https://progress.watch/mcp/{space_uuid}"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "progress-watch": {
            "type": "http",
            "url": "https://progress.watch/mcp/{space_uuid}"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http progress-watch https://progress.watch/mcp/{space_uuid}
```

## When to use it
- 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
- 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.

## Similar
- [bjj-belt-progress](https://affpapa.org/en/nevibecode/mcp/bjj-belt-progress.md) — MCP server · 3549 installs
- [scroll-progress-timeline](https://affpapa.org/en/nevibecode/skills/scroll-progress-timeline.md) — skill · 1800 installs
- [ruler-progress-render](https://affpapa.org/en/nevibecode/skills/ruler-progress-render.md) — skill · 1200 installs
- [syncfusion-react-progress-bar](https://affpapa.org/en/nevibecode/skills/syncfusion-react-progress-bar.md) — skill · 685 installs
- [workflow-progress-screenshots](https://affpapa.org/en/nevibecode/skills/workflow-progress-screenshots.md) — skill · 682 installs
- [gsd-progress](https://affpapa.org/en/nevibecode/skills/gsd-progress.md) — skill · 581 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
