# Go2Clock MCP by usefulapi

> Go2Clock MCP by usefulapi is an MCP server. Read clock records, timesheets and rotas; change employees and rotas, add clock records in Go2Clock. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/go2clock/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/go2clock
- **MCP Registry name:** io.usefulapi/go2clock
- **Listing updated:** 2026-11-13

## About

Read clock records, timesheets and rotas; change employees and rotas, add clock records in Go2Clock.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http go2clock https://go2clock.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://go2clock.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "go2clock": {
      "url": "https://go2clock.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "go2clock": {
      "type": "http",
      "url": "https://go2clock.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "go2clock": {
      "serverUrl": "https://go2clock.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "go2clock": {
      "type": "http",
      "url": "https://go2clock.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `go2clock_list_users`: List every clock user with id, name, department, shift, payroll number and manager flag. Clock PINs are removed. Go2Clock API: POST /api/users/.
- `go2clock_list_employees`: List employee details: contact, department, trade, pay rates, roles, start and termination dates. Go2Clock API: POST /api/employees/.
- `go2clock_list_clock_records`: List every clocking record (punch) for one date. Go2Clock API: POST /api/punches/ with punch_date.
- `go2clock_list_clock_records_range`: List clocking records between two dates, optionally for one employee. Keep the range to 7 days or fewer per call; Go2Clock advises against larger pulls. Go2Clock API: POST /api/punches_range/.
- `go2clock_get_timesheet_csv`: Generate the timesheet report as CSV for up to 7 days, optionally for one department or one employee. Returns the CSV text. Go2Clock API: POST /api/timesheet_csv_v1.
- `go2clock_get_rota`: Read an employee's rota (shift schedule) between two dates: shift name, colour and planned hours per day. Go2Clock API: GET /api/employee_rota.
- `go2clock_update_employee`: Change some details of one existing employee. Send only the fields to change. Go2Clock API: PUT /api/employee_update. Does not change sign-in passwords or roles.
- `go2clock_upload_employees`: Upload a list of employees (new or changed). Go2Clock keys each record on userid. Sends a JSON array. Go2Clock API: PUT /api/employees/. Does not set passwords or roles.
- `go2clock_upload_clock_record`: Add one clocking record (punch) for an employee. Go2Clock refuses a duplicate record. Go2Clock API: PUT /api/punches/.
- `go2clock_create_rota`: Put a named shift on an employee's rota for one or more days from a start date. An existing rota entry on the same date is replaced. The shift name must match a shift in Go2Clock's shift settings. Go2Clock API: POST /api/employee_rota.

## FAQ

### How do I add Go2Clock MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http go2clock https://go2clock.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/go2clock-mcp-by-usefulapi
