Papershift MCP by usefulapi
Read Papershift absences, vacation, time tracking and shifts; request and review absences.
사용해야 할까요
품질 및 안전성
발견 사항 (5)
- LOWTool 'papershift_list_vacation_entitlements' name length outside 3-30 rangepapershift_list_vacation_entitlements에서
- LOWTool 'papershift_list_shift_assignments' name length outside 3-30 rangepapershift_list_shift_assignments에서
- LOWTool 'papershift_create_time_tracking' name length outside 3-30 rangepapershift_create_time_tracking에서
- LOWTool 'papershift_confirm_time_tracking' name length outside 3-30 rangepapershift_confirm_time_tracking에서
- LOWTool 'papershift_assign_user_to_shift' name length outside 3-30 rangepapershift_assign_user_to_shift에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"papershift": {
"url": "https://papershift.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://papershift.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (26)
🟢papershift_get_account
The Papershift account this API key belongs to (id and name). A quick way to check the connection. GET /accounts.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_list_locations
List all locations (sites/companies inside the account) with id, name and status. Most other tools need a location id from here. GET /locations.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_get_location(location_id)
One location by id. GET /locations?id=.
입력 스키마
{
"type": "object",
"properties": {
"location_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift location id."
}
},
"required": [
"location_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_list_working_areas(location_id)
List working areas (departments/stations shifts are planned in), optionally for one location. Use the ids for shifts and time trackings. GET /working_areas.
입력 스키마
{
"type": "object",
"properties": {
"location_id": {
"description": "Only the working areas of this location.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_list_users(location_id, working_area_id, tag_ids, page)
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.
입력 스키마
{
"type": "object",
"properties": {
"location_id": {
"description": "Only employees of this location.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"working_area_id": {
"description": "Only employees in this working area.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"tag_ids": {
"description": "Only records with one of these tag ids (from papershift_list_tags). Include 0 to also match records without tags.",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"page": {
"description": "Page number, from 1 (default 1; 25 records per page). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_get_user(user_id)
One employee by id: contact data, status, locations, working areas, tags and profile fields. GET /users?id=.
입력 스키마
{
"type": "object",
"properties": {
"user_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift user id."
}
},
"required": [
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_list_tags(location_id)
List the tags of a location (labels on shifts, time trackings and employees). GET /filters.
입력 스키마
{
"type": "object",
"properties": {
"location_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift location id."
}
},
"required": [
"location_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_list_absence_types(location_id, page)
List the absence types of a location (vacation, sick leave, ...) with id, title and rules. Use the ids to create absences. GET /absence_types.
입력 스키마
{
"type": "object",
"properties": {
"location_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift location id."
},
"page": {
"description": "Page number, from 1 (default 1; 25 records per page). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"required": [
"location_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_list_absences(range_start, range_end, user_id, location_id, page)
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.
입력 스키마
{
"type": "object",
"properties": {
"range_start": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day of the range, yyyy-mm-dd."
},
"range_end": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last day of the range, yyyy-mm-dd."
},
"user_id": {
"description": "Only this employee.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"location_id": {
"description": "Only this location.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page": {
"description": "Page number, from 1 (default 1; 25 records per page). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"required": [
"range_start",
"range_end"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_get_absence(absence_id)
One absence by id, with its status, confirmation, hours and vacation days. GET /absences?id=.
입력 스키마
{
"type": "object",
"properties": {
"absence_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift absence id."
}
},
"required": [
"absence_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_list_vacation_entitlements(user_id, start_date, end_date, page)
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.
입력 스키마
{
"type": "object",
"properties": {
"user_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift user id."
},
"start_date": {
"description": "Only entitlements from this date, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"end_date": {
"description": "Only entitlements up to this date, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"page": {
"description": "Page number, from 1 (default 1; 25 records per page). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"required": [
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_list_time_trackings(range_start, range_end, user_id, page)
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.
입력 스키마
{
"type": "object",
"properties": {
"range_start": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day, yyyy-mm-dd."
},
"range_end": {
"description": "Last day, yyyy-mm-dd (default: no end).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"user_id": {
"description": "Only this employee.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page": {
"description": "Page number, from 1 (default 1; 25 records per page). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"required": [
"range_start"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_get_time_tracking(time_tracking_id)
One worked-time entry by id, with its breaks, tags and break total. GET /working_sessions?id=.
입력 스키마
{
"type": "object",
"properties": {
"time_tracking_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift time tracking (working session) id."
}
},
"required": [
"time_tracking_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_list_evaluations(user_id, range_start, range_end, page)
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.
입력 스키마
{
"type": "object",
"properties": {
"user_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift user id."
},
"range_start": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day, yyyy-mm-dd."
},
"range_end": {
"description": "Last day, yyyy-mm-dd (default: today).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"page": {
"description": "Page number, from 1 (default 1; 25 records per page). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"required": [
"user_id",
"range_start"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_list_target_hours(user_id, start_date, end_date, page)
An employee's contractual target hours (weekly/monthly rhythm and hours per weekday) over time. 25 per page. GET /target_hours.
입력 스키마
{
"type": "object",
"properties": {
"user_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift user id."
},
"start_date": {
"description": "Only entries from this date, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"end_date": {
"description": "Only entries up to this date, yyyy-mm-dd.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"page": {
"description": "Page number, from 1 (default 1; 25 records per page). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"required": [
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_list_payrolls(user_id, page)
An employee's payroll entries (paid hours, salary, bonus, time-account start/end per period). Sensitive pay data. 25 per page. GET /payrolls.
입력 스키마
{
"type": "object",
"properties": {
"user_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift user id."
},
"page": {
"description": "Page number, from 1 (default 1; 25 records per page). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"required": [
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_list_shifts(location_id, range_start, range_end, working_area_id, tag_ids, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"location_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift location id."
},
"range_start": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day, yyyy-mm-dd."
},
"range_end": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last day, yyyy-mm-dd."
},
"working_area_id": {
"description": "Only this working area.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"tag_ids": {
"description": "Only records with one of these tag ids (from papershift_list_tags). Include 0 to also match records without tags.",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"page": {
"description": "Page number, from 1 (default 1; 25 records per page). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"required": [
"location_id",
"range_start",
"range_end"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_get_shift(shift_id)
One shift by id. GET /shifts?id=.
입력 스키마
{
"type": "object",
"properties": {
"shift_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift shift id."
}
},
"required": [
"shift_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_list_shift_assignments(shift_id)
Who is assigned to a shift and who has applied for it (user id and name). GET /assignments?shift_id=.
입력 스키마
{
"type": "object",
"properties": {
"shift_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift shift id."
}
},
"required": [
"shift_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢papershift_list_availabilities(user_id, start_date, end_date, page)
The times an employee has marked as available between two dates. 25 per page. GET /availabilities.
입력 스키마
{
"type": "object",
"properties": {
"user_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift user id."
},
"start_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day, yyyy-mm-dd."
},
"end_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last day, yyyy-mm-dd."
},
"page": {
"description": "Page number, from 1 (default 1; 25 records per page). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
}
},
"required": [
"user_id",
"start_date",
"end_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴papershift_create_absence(user_id, absence_type_id, starts_at, ends_at, full_day, ...)
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 may be notified. Papershift calculates the paid hours and vacation days. POST /absences.
입력 스키마
{
"type": "object",
"properties": {
"user_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Employee the absence is for."
},
"absence_type_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Absence type id."
},
"starts_at": {
"type": "string",
"description": "ISO 8601 date-time with a timezone, e.g. 2026-11-02T08:00:00+01:00."
},
"ends_at": {
"type": "string",
"description": "ISO 8601 date-time with a timezone, e.g. 2026-11-02T08:00:00+01:00."
},
"full_day": {
"description": "True for whole-day absences.",
"type": "boolean"
},
"time_zone": {
"description": "IANA time zone of the times, e.g. Europe/Berlin (recommended).",
"type": "string",
"maxLength": 64,
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:\\/[A-Za-z0-9_+-]+){0,2}$"
}
},
"required": [
"user_id",
"absence_type_id",
"starts_at",
"ends_at"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴papershift_review_absence(absence_id, action)
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/{confirm|reject|reset}.
입력 스키마
{
"type": "object",
"properties": {
"absence_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift absence id."
},
"action": {
"type": "string",
"enum": [
"confirm",
"reject",
"reset"
],
"description": "The decision."
}
},
"required": [
"absence_id",
"action"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴papershift_create_time_tracking(user_id, location_id, working_area_id, starts_at, ends_at, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"user_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Employee who worked."
},
"location_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Location the work was done in."
},
"working_area_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Working area the work was done in."
},
"starts_at": {
"type": "string",
"description": "ISO 8601 date-time with a timezone, e.g. 2026-11-02T08:00:00+01:00."
},
"ends_at": {
"type": "string",
"description": "ISO 8601 date-time with a timezone, e.g. 2026-11-02T08:00:00+01:00."
},
"manual_pause": {
"description": "Break length in minutes.",
"type": "integer",
"minimum": 0,
"maximum": 1440
}
},
"required": [
"user_id",
"location_id",
"working_area_id",
"starts_at",
"ends_at"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴papershift_confirm_time_tracking(time_tracking_id)
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.
입력 스키마
{
"type": "object",
"properties": {
"time_tracking_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift time tracking (working session) id."
}
},
"required": [
"time_tracking_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴papershift_create_shift(location_id, working_area_id, starts_at, ends_at, number_of_employees, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"location_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Location of the shift."
},
"working_area_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Working area of the shift."
},
"starts_at": {
"type": "string",
"description": "ISO 8601 date-time with a timezone, e.g. 2026-11-02T08:00:00+01:00."
},
"ends_at": {
"type": "string",
"description": "ISO 8601 date-time with a timezone, e.g. 2026-11-02T08:00:00+01:00."
},
"number_of_employees": {
"type": "integer",
"minimum": 1,
"maximum": 500,
"description": "How many employees the shift needs."
},
"note": {
"description": "Optional note shown on the shift.",
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"visible": {
"description": "Whether employees can see the shift (published).",
"type": "boolean"
},
"tag_ids": {
"description": "Tag ids to put on the shift (papershift_list_tags).",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
}
},
"required": [
"location_id",
"working_area_id",
"starts_at",
"ends_at",
"number_of_employees"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴papershift_assign_user_to_shift(shift_id, user_id, application)
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.
입력 스키마
{
"type": "object",
"properties": {
"shift_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Papershift shift id."
},
"user_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Employee to assign."
},
"application": {
"description": "True = record as an application instead of assigning directly.",
"type": "boolean"
}
},
"required": [
"shift_id",
"user_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거