# Chronicle Online MCP by usefulapi

> Chronicle Online MCP by usefulapi is a freemium MCP server for hr and payroll. Hosted MCP server giving AI assistants read-only access to Chronicle Online HR and time. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** Web, API, vscode, CLI
- **Website:** https://usefulapi.io/chronicle-online/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/chronicle-online
- **MCP Registry name:** io.usefulapi/chronicle-online
- **Categories:** hr and payroll
- **Listing updated:** 2026-11-18

## About

The server connects an AI client to a Chronicle Online account so staff records, clockings, absences, rotas and overtime can be queried in plain language. Sign-in happens through an OAuth login page that asks for Chronicle API client credentials, so the server only sees what that account can already see.

All 15 data tools are read-only, covering employees, leavers, cost centres, absence types and records, real clockings, shift patterns, scheduled shifts, work records and daily or weekly overtime. Four additional tools report usage, handle upgrades and cancellations, and log feature requests.

The server is aimed at UK employers and HR or payroll teams that already run time and attendance in Chronicle Online. It is hosted by usefulapi, an independent service not affiliated with Chronicle Online, and runs as a remote Streamable HTTP endpoint rather than a local install.

## Features

- **Read-only Chronicle access:** All fifteen data tools only read employees, absences, clockings, shifts and overtime; none change records.
- **OAuth sign-in:** Clients authenticate through a login page using Chronicle API credentials rather than keys in config files.
- **Overtime and work records:** Daily and weekly overtime and worked time per employee can be pulled for a chosen date range.
- **Shift and cover planning:** Shift patterns and scheduled shifts between two dates can be listed and grouped by cost centre.
- **Usage metering:** A status tool reports calls used against the monthly plan limit.

## Good for

- Finding employees who clocked in late during a date range
- Reviewing absences booked in a given period
- Checking overtime totals before payroll is run
- Reviewing shift cover for teams by cost centre
- Producing a leavers report grouped by team

## Install

### Claude Code (Terminal)

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

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

```sh
https://chronicle-online.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "chronicle-online": {
      "url": "https://chronicle-online.usefulapi.io/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "chronicle-online": {
      "serverUrl": "https://chronicle-online.usefulapi.io/mcp"
    }
  }
}
```

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

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

## Tools

- `chronicleonline_list_employees`: List employees (and contractors, visitors, agency staff) with badge ids, names and cost centre.
- `chronicleonline_get_employee`: Get one employee by id.
- `chronicleonline_list_absences`: List absences configured in Chronicle.
- `chronicleonline_get_absence`: Get one absence by id.
- `chronicleonline_list_absence_types`: List the absence types Chronicle uses.
- `chronicleonline_list_absentee_records`: List absentee records of absence taken per employee.
- `chronicleonline_list_real_clockings`: List real clockings (IN and OUT punches).
- `chronicleonline_get_real_clocking`: Get one real clocking by id.
- `chronicleonline_list_shifts`: List shift patterns defined in Chronicle.
- `chronicleonline_list_scheduled_shifts`: List shifts scheduled to employees between two dates.
- `chronicleonline_list_work_records`: List work records (worked time per employee) between two dates.
- `chronicleonline_list_daily_overtime`: List daily overtime per employee between two dates.
- `chronicleonline_list_weekly_overtime`: List weekly overtime per employee between two dates.
- `chronicleonline_list_cost_centres`: List cost centres used to group employees and time.
- `chronicleonline_list_leavers`: List employees who have left.

## FAQ

### Is this an official Chronicle Online product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Chronicle Online.

### What do I need to connect?

The login page asks for your Chronicle API Client ID and Chronicle API Client Secret, which Chronicle issues on request.

### Can the AI change my Chronicle Online data?

No. All 15 Chronicle Online tools are marked read-only.

### Which AI clients can I use?

Any client that supports remote MCP servers over Streamable HTTP with OAuth login, including Claude, Claude Code, ChatGPT, Codex, Cursor and VS Code.

### Is Chronicle Online MCP by usefulapi free?

Chronicle Online MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

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

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

### What are the best alternatives to Chronicle Online MCP by usefulapi?

The closest alternatives to Chronicle Online MCP by usefulapi are When I Work MCP by usefulapi, Employment Hero Payroll MCP by usefulapi, intelliHR MCP by usefulapi, Bilflo MCP by usefulapi and PaySpace MCP by usefulapi.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [When I Work MCP by usefulapi](https://ai-powered.com/mcp/when-i-work-mcp-by-usefulapi): When I Work MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Employment Hero Payroll MCP by usefulapi](https://ai-powered.com/mcp/employment-hero-payroll-mcp-by-usefulapi): Employment Hero Payroll MCP by usefulapi is a freemium MCP server for hr and payroll.
- [intelliHR MCP by usefulapi](https://ai-powered.com/mcp/intellihr-mcp-by-usefulapi): intelliHR MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Bilflo MCP by usefulapi](https://ai-powered.com/mcp/bilflo-mcp-by-usefulapi): Bilflo MCP by usefulapi is a freemium MCP server for hr and payroll.
- [PaySpace MCP by usefulapi](https://ai-powered.com/mcp/payspace-mcp-by-usefulapi): PaySpace MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Jisr MCP by usefulapi](https://ai-powered.com/mcp/jisr-mcp-by-usefulapi): Jisr MCP by usefulapi is a freemium MCP server for hr and payroll.
- [clockin MCP by usefulapi](https://ai-powered.com/mcp/clockin-mcp-by-usefulapi): clockin MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Breathe HR MCP by usefulapi](https://ai-powered.com/mcp/breathe-hr-mcp-by-usefulapi): Breathe HR MCP by usefulapi is a freemium MCP server for hr and payroll.

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