# Aladtec MCP by usefulapi

> Aladtec MCP by usefulapi is a freemium MCP server for productivity. Read-only hosted MCP server for Aladtec shift schedules, time clock and payroll reports. 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:** API
- **Website:** https://usefulapi.io/aladtec/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/aladtec
- **MCP Registry name:** io.usefulapi/aladtec
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

Where its siblings can write, this server only reads. It is meant for schedulers and managers of shift-based teams, such as emergency services, who run their rota and time clock in Aladtec. Typical questions are who is on the night shift next Monday, which open shifts still need cover and who is clocked in right now and at which kiosk.

Payroll preparation is a named use: it lists time clock records and paycodes for a pay period and runs the payroll report export, passing the next token to page through everything. Accrual banks and balances can be read for a list of members, and work groups reveal the scheduling and overtime rules that apply.

To connect you enter your Aladtec server name (the secureN part of your API address), the system name, and the client ID and secret that Aladtec Support issues per system. The secret gives full read access to the system's data, so keep it private. Some member fields and routes return null or an error until Aladtec enables them for the API profile.

## Features

- **Who is on shift now:** Lists members scheduled right now with schedule and position, and who is clocked in.
- **Open time search:** Finds unfilled time in a date range and checks member availability for it.
- **Time off review:** Lists time off requests in a range, including pending ones.
- **Payroll report export:** Pulls time clock records, paycodes and the payroll report with paging.
- **Accruals and rules:** Reads accrual banks, balances and work group overtime rules.
- **Strictly read-only:** The server never writes to the Aladtec system.

## Good for

- Staff an open shift for this week
- Review pending time off before approving
- Prepare payroll from time clock records
- Check accrual balances for a crew
- See who is clocked in at a given kiosk

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `aladtec_list_members`: List members with their Member Database attributes, sorted by last name. Attributes not enabled for the API return null. Read only.
- `aladtec_list_employee_types`: List the employee types of the system, for example full time or part time. Read only.
- `aladtec_list_custom_attributes`: List the custom Member Database attribute definitions. Read only.
- `aladtec_get_availability`: Get the availability of members for a date and time range. Read only.
- `aladtec_list_time_off`: List time off requests in a range. Approved requests only, unless statuses includes pending. Read only.
- `aladtec_list_schedules`: List the schedules of the system, in the order set on the Setup page. Read only.
- `aladtec_list_position_qualifications`: List the unique position qualifications. Read only.
- `aladtec_list_scheduled_time`: List scheduled time ranges for a period, with the member and position for each. Read only.
- `aladtec_list_open_time`: List time ranges where no member is scheduled, for finding shifts that need cover. Up to one month per request. Read only.
- `aladtec_list_members_scheduled_now`: List each member scheduled at the time of the request, with the schedule and position. Read only.
- `aladtec_list_schedule_notes`: List schedule notes by calendar date. Up to one year per request. Read only.
- `aladtec_list_extra_hours`: List extra hours in a past period. Read only.
- `aladtec_list_paycodes`: List the active paycodes that can be applied to time clock time. Read only.
- `aladtec_list_kiosks`: List the active kiosks that members use to clock in and out. Read only.
- `aladtec_list_time_clock_records`: List time clock records in a range. Members still clocked in are left out. Read only.
- `aladtec_list_clocked_in_members`: List the members clocked in at the time of the request. Read only.
- `aladtec_list_events`: List events (title, description, location) in a date and time range. Read only.
- `aladtec_list_shift_labels`: List shift labels, such as A/B/C or Red/Gold/Black, for a date range. Read only.
- `aladtec_list_work_groups`: List all work groups, which hold the scheduling and overtime rules for members. Read only.
- `aladtec_list_time_types`: List the unique time types that can be applied to scheduled time. Read only.
- `aladtec_list_accrual_banks`: List all time off accrual banks. Read only.
- `aladtec_get_accrual_balances`: Get the hours in each accrual bank for a list of members. Read only.
- `aladtec_get_configuration`: Get the configuration settings of the system. Read only.
- `aladtec_get_payroll_report`: Run the payroll report export for a range. Pass next_token from the previous reply to get the next page. Read only.

## FAQ

### Can it change the schedule?

No. The server reads data only and never writes.

### What credentials does it need?

Your Aladtec server name, system name, and a client ID and secret issued by Aladtec Support.

### Why might a field come back empty?

Some member fields and routes return null or an error until Aladtec enables them for the API profile.

### What does it cost?

Free for 50 tool calls a month; Pro is $9 and Pro+ $39 a month per user.

### Is Aladtec MCP by usefulapi free?

Aladtec 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 Aladtec MCP by usefulapi to Claude Code?

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

### What are the best alternatives to Aladtec MCP by usefulapi?

The closest alternatives to Aladtec MCP by usefulapi are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

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