# Protime MCP by usefulapi

> Protime MCP by usefulapi is an MCP server. Read clockings, absences, assignments, contracts, people and departments in Protime. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read clockings, absences, assignments, contracts, people and departments in Protime.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `protime_list_clockings`: List time clockings (in/out, reasons, activities) for a date range. Deleted clockings have status Deleted. Location data is left out. A date range is required (at most one year). Returns one page: pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-clockings.read.
- `protime_list_absences`: List absence instances (leave, sickness) for a date range. A date range is required (at most one year). Returns one page: pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-absences.read.
- `protime_list_assignments`: List work assignments (planned and registered activities) for a date range. A date range is required. Returns one page: pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-assignments.read.
- `protime_list_contracts`: List employment contracts (percentage, hours, dates). Optional person filter. Returns one page: pass continuationToken for the next. Read only. Needs scope connector-protimeapi-contracts.read.
- `protime_list_people`: List people with name, work email and service dates. Home address, birth date, bank, passport and social security data are never returned. Optional person filter. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-people.read.
- `protime_list_departments`: List all departments configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-departments.read.
- `protime_list_jobs`: List all jobs configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-jobs.read.
- `protime_list_work_locations`: List all work locations configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-work-locations.read.
- `protime_list_shift_definitions`: List all shift definitions (codes and names) configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-shift-definitions.read.
- `protime_list_absence_definitions`: List all absence definitions (codes, groups) configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-absence-definitions.read.
- `protime_list_absence_groups`: List all absence groups configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-absence-groups.read.
- `protime_get_person`: Get one person by internal ID: name, work email, service dates. Sensitive personal data is never returned. Read only. Needs scope connector-protimeapi-people.read.

## FAQ

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

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

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