MCP server

Papershift MCP by usefulapi

io.usefulapi/papershift

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

Read Papershift absences, vacation, time tracking and shifts; request and review absences.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

26

Token cost

About 5,412 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.papershift]
url = "https://papershift.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"papershift":{"httpUrl":"https://papershift.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"papershift":{"url":"https://papershift.usefulapi.io/mcp"}}}

VS Code

{"servers":{"papershift":{"type":"http","url":"https://papershift.usefulapi.io/mcp"}}}

Antigravity

agy mcp add papershift https://papershift.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"papershift","server_url":"https://papershift.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"papershift","server_url":"https://papershift.usefulapi.io/mcp"}

Tools

• papershift_assign_user_to_shift ~229 tokens
  WRITE: put an employee on a shift (or, with application true, record them as having applied for it). The employee is typically notified of the assignment. An already assigned user is re-assigned. Returns the shift's assigned and applied users. POST /assignments.
• papershift_confirm_time_tracking ~148 tokens
  WRITE: confirm (approve) a worked-time entry so it counts as final for payroll and balances. Find ids with papershift_list_time_trackings. PUT /working_sessions/confirm.
• papershift_create_absence ~383 tokens
  WRITE: record an absence (vacation, sick leave, ...) for an employee. Get the absence type id from papershift_list_absence_types and the user id from papershift_list_users. Whether it counts immediately or waits for approval depends on the absence type and the account's approval rules; the employee
• papershift_create_shift ~428 tokens
  WRITE: plan a new shift in a location and working area for a number of employees. Set visible to true only if employees should see it right away (default: left to the account's setting). Assign people afterwards with papershift_assign_user_to_shift. POST /shifts.
• papershift_create_time_tracking ~355 tokens
  WRITE: add a worked-time entry for an employee after the fact (start, end and break minutes) in a location and working area. It changes the employee's recorded hours and balance. Ids from papershift_list_locations, papershift_list_working_areas and papershift_list_users. POST /working_sessions.
• papershift_get_absence ~113 tokens
  One absence by id, with its status, confirmation, hours and vacation days. GET /absences?id=.
• papershift_get_account ~77 tokens
  The Papershift account this API key belongs to (id and name). A quick way to check the connection. GET /accounts.
• papershift_get_location ~98 tokens
  One location by id. GET /locations?id=.
• papershift_get_shift ~93 tokens
  One shift by id. GET /shifts?id=.
• papershift_get_time_tracking ~125 tokens
  One worked-time entry by id, with its breaks, tags and break total. GET /working_sessions?id=.
• papershift_get_user ~114 tokens
  One employee by id: contact data, status, locations, working areas, tags and profile fields. GET /users?id=.
• papershift_list_absence_types ~178 tokens
  List the absence types of a location (vacation, sick leave, ...) with id, title and rules. Use the ids to create absences. GET /absence_types.
• papershift_list_absences ~303 tokens
  List absences (vacation, sick leave, ...) that fall between two dates, optionally for one employee or location. Shows type title, times, hours, vacation days and whether it is confirmed. 25 per page. GET /absences.
• papershift_list_availabilities ~232 tokens
  The times an employee has marked as available between two dates. 25 per page. GET /availabilities.
• papershift_list_evaluations ~256 tokens
  An employee's daily evaluations: target, planned and actual hours, vacation and compensation per day. Use it for overtime and balance questions. 25 per page. GET /evaluations.
• papershift_list_locations ~87 tokens
  List all locations (sites/companies inside the account) with id, name and status. Most other tools need a location id from here. GET /locations.
• papershift_list_payrolls ~173 tokens
  An employee's payroll entries (paid hours, salary, bonus, time-account start/end per period). Sensitive pay data. 25 per page. GET /payrolls.
• papershift_list_shift_assignments ~116 tokens
  Who is assigned to a shift and who has applied for it (user id and name). GET /assignments?shift_id=.
• papershift_list_shifts ~382 tokens
  List planned shifts of a location between two dates, optionally for one working area or tags. Shows start, end, number of employees needed, note and visibility. Assigned employees: papershift_list_shift_assignments. 25 per page. GET /shifts.
• papershift_list_tags ~112 tokens
  List the tags of a location (labels on shifts, time trackings and employees). GET /filters.
• papershift_list_target_hours ~244 tokens
  An employee's contractual target hours (weekly/monthly rhythm and hours per weekday) over time. 25 per page. GET /target_hours.
• papershift_list_time_trackings ~264 tokens
  List worked-time entries (clock-ins) from a start date, optionally to an end date and for one employee. Shows start, end, break time, location, employee and whether confirmed. 25 per page. GET /working_sessions.
• papershift_list_users ~292 tokens
  List employees (users) with name, email, status, contract basics and their location, working-area and tag ids. Filter by location, working area or tag. 25 per page. GET /users.
• papershift_list_vacation_entitlements ~272 tokens
  An employee's vacation entitlements (planned days, spent days, expiry, carry-over) for the given period. Use it to answer 'how many vacation days does X have left'. 25 per page. GET /vacation_entitlements.
• papershift_list_working_areas ~131 tokens
  List working areas (departments/stations shifts are planned in), optionally for one location. Use the ids for shifts and time trackings. GET /working_areas.
• papershift_review_absence ~207 tokens
  WRITE: decide on an absence request. action 'confirm' approves it (it then counts against vacation days and the plan), 'reject' declines it, 'reset' puts a decided absence back to pending. The employee is typically notified of the decision. Find ids with papershift_list_absences. PUT /absences/{conf

Related MCP servers

• Shiftbase MCP by usefulapi
  Read Shiftbase rosters, timesheets, absences and availability; schedule shifts and review absences.
• kiwiHR MCP by usefulapi
  Read kiwiHR employees, time off, timesheets, projects; create and update employees, timesheets.
• Connecteam MCP by usefulapi
  Read Connecteam users, shifts, time clock, jobs, time off, tasks and forms; create shifts and tasks.
• Tamigo MCP by usefulapi
  Read Tamigo departments, employees, shifts, absences and opening hours; register attendance.
• RotaCloud MCP by usefulapi
  Read RotaCloud shifts, attendance, leave, availability and payroll; create shifts and handle leave.
• Homebase MCP by usefulapi
  Read Homebase locations, employees, shifts, timecards, labor costs and time clock status.
• When I Work MCP by usefulapi
  Check shifts, time clock entries, time-off requests, swaps and availability, and manage shifts.
• Boulevard MCP by usefulapi
  Look up appointments, clients, services, staff and orders, and update clients in Boulevard.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/papershift.svg)](https://aptlynx.net/servers/io.usefulapi/papershift)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents