MCP server
Protime MCP by usefulapi
Read clockings, absences, assignments, contracts, people and departments in Protime.
- Runs
- Remotely
- Version
- 1.7.0
- Listing updated
- 4 days ago
About Protime MCP by usefulapi
Protime MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add --transport http protime https://protime.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://protime.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"protime": {
"url": "https://protime.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": {
"protime": {
"type": "http",
"url": "https://protime.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"protime": {
"serverUrl": "https://protime.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"protime": {
"type": "http",
"url": "https://protime.usefulapi.io/mcp"
}
}
}Tools this server provides (12)
Read directly from the server.
- 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.
Protime MCP by usefulapi 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