Skip to content
MCP server

Chronicle Online MCP by usefulapi

Hosted MCP server giving AI assistants read-only access to Chronicle Online HR and time

Install
Pricing
Freemium
Platforms
Web, API, vscode
Runs
Remotely
Version
1.7.1
Listing updated
today

About Chronicle Online MCP by usefulapi

Chronicle Online MCP by usefulapi is a freemium MCP server for hr and payroll. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://chronicle-online.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "chronicle-online": {
      "url": "https://chronicle-online.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (15)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $9 a month

Free plan with 50 tool calls/month; Pro $9/mo or $90/yr; Pro+ $39/mo or $390/yr

Prices change. Check usefulapi.io before you buy.

Chronicle Online MCP by usefulapi 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.

How AIPoweredBot checks servers

Alternatives to Chronicle Online MCP by usefulapi

  1. Hosted MCP server connecting When I Work scheduling, timesheets and time off to AI clients

    Not checked yet
    • 21 tools
    • Remote
    • Freemium
    • Hr and payroll
  2. Hosted MCP server letting AI assistants read and update intelliHR people, jobs and leave

    Not checked yet
    • 22 tools
    • Remote
    • Freemium
    • Hr and payroll
  3. Hosted MCP server connecting Claude or ChatGPT to Bilflo staffing data for clients, jobs

    Not checked yet
    • 26 tools
    • Remote
    • Freemium
    • Hr and payroll
  4. Read-only MCP server giving AI assistants access to PaySpace HR and payroll records

    Not checked yet
    • 21 tools
    • Remote
    • Freemium
    • Hr and payroll
  5. Hosted MCP server connecting AI assistants to Jisr HR, attendance and payroll data

    Not checked yet
    • 16 tools
    • Remote
    • Freemium
    • Hr and payroll