Connect other tools

Clockwork can let another tool read company information. You may use this for reporting or to let an AI assistant answer questions about attendance. A technical colleague will usually configure the connection.

Create a personal key

1. Select the company whose information you want to connect.
2. Open Settings and find Personal API keys.
3. Select Create API key.
4. Copy the key and store it securely. It is only shown when created.
5. Give it to the approved tool as part of its connection setup.

All seven roles can create a personal key. A key expires after 90 days and follows your current role in the company selected when it was created. It does not give another tool access beyond that role. If you leave the company, that personal key no longer has access to its information.

Treat the key like a password. Share it only with the tool or person setting up the intended connection.

Reporting connections

The API can read company details, worker and contractor lists, sites, holiday requests and allowances, company and bank holidays, visitors, timesheets and the current signed-in list. Access to each type of information depends on the key’s permissions.

For a technical colleague, the API is under /api/v1 and its machine-readable reference is /api/v1/openapi.json. Requests use the X-Api-Key header. The available reporting routes read records; they do not provide the dashboard’s approval and editing workflows.

AI assistants

Clockwork’s MCP connection is at /mcp and also uses X-Api-Key. It provides four tools: get company details, list members, search members by name and retrieve timesheet shifts for a date range.

Company and member queries require access to the full member list. Timesheet queries require access to company timesheets. A Member or Inviter’s personal key therefore cannot use those tools simply because they can create a key.

For a one-off report, Exports lets you download the data without setting up a connection.