# progi MCP server

> Enables AI agents to execute structured, repeatable workflows by storing processes as persistent playbooks and monitoring task progress.

- Repository: https://github.com/zseta/progi
- Page: https://hostedmcp.org/servers/zseta/progi
- Transport: stdio
- Stars: 3
- License: MIT
- Latest version: 0.3.2

## Install

### Claude Code

```sh
claude mcp add progi -- uvx progi
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "progi": {
      "command": "uvx",
      "args": [
        "progi"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "progi": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "progi"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"progi","type":"stdio","command":"uvx","args":["progi"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "progi": {
      "command": "uvx",
      "args": [
        "progi"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add progi -- uvx progi
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.progi]
command = "uvx"
args = ["progi"]
```

### Gemini CLI

```sh
gemini mcp add -s user progi uvx -- progi
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "progi": {
      "command": "uvx",
      "args": [
        "progi"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `PROGI_DB_PATH` | no | no | Custom path for the Progi SQLite database file |
| `PROGI_WEB_PORT` | no | no |  |

## Tools (9)

- `create_task`
- `list_tasks`
- `start_or_continue_task`
- `update_progress_notes`
- `finish_step`
- `get_process_skeleton_prompt`
- `get_playbook_authoring_prompt`
- `save_workflow`
- `list_workflows`

## FAQ

### How do I add Progi to my MCP client?

You can add it to your configuration (like Claude Code or Cursor) using the uvx command with the progi argument.

### Can I change the port for Progi Monitoring?

Yes, you can change the monitoring port by setting the PROGI_WEB_PORT environment variable in your configuration.

### Where is the workflow data stored?

Workflows are stored in a SQLite database, with the location determined by the PROGI_DB_PATH variable.

### How can I disable the web UI?

You can disable the web UI by setting the PROGI_NO_WEB environment variable to 1.