Connecteam MCP by usefulapi
by usefulapi.io · remote · no sign-in to list tools · v1.7.3 · published by io.usefulapi
Read Connecteam users, shifts, time clock, jobs, time off, tasks and forms; create shifts and tasks.
19 tools: 2 can delete or cancel things and 17 only read.
Scanned Oct 21, 2026
- Deletes or cancels2Claude Code: deny: see these tools
- Can't be undone0Claude Code: ask
- Changes things0Claude Code: ask
- Only reads17Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http connecteam https://connecteam.usefulapi.io/mcpTools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
19 tools
Deletes or cancels 2Claude Code: deny
connecteam_create_shiftWRITE: create ONE shift in a scheduler (one assignee or one open spot: the V1 endpoint does not create group or multi-spot shifts).No findings
Why it is in this group
- The name "connecteam_create_shift" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it WRITE: create ONE shift in a scheduler (one assignee or one open spot: the V1 endpoint does not create group or multi-spot shifts). By default it is created as an unpublished draft (employees see nothing). With is_published=true it is published, and Connecteam notifies the assigned users unless notify_users=false. Give a title or a job_id (Connecteam requires one). For an open shift set is_open_shift=true and leave assigned_user_ids empty. POST /scheduler/v1/schedulers/{schedulerId}/shifts.
Annotations the server declares
- title: Create shift
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: false
- openWorldHint: true
connecteam_create_taskWRITE: create one quick task on a task board for the given users.No findings
Why it is in this group
- The name "connecteam_create_task" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it WRITE: create one quick task on a task board for the given users. status 'draft' keeps it hidden; 'published' sends it to the assignees' apps. Several user ids make one group task. POST /tasks/v1/taskboards/{taskBoardId}/tasks.
Annotations the server declares
- title: Create task
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: false
- openWorldHint: true
Only reads 17Claude Code: allow
connecteam_get_accountThe Connecteam company this API key belongs to: company name and company id.No findings
Why it is in this group
- The name "connecteam_get_account" says "get": a word for reading.
Description, as the server wrote it The Connecteam company this API key belongs to: company name and company id. GET /me.
Annotations the server declares
- title: Get account
- readOnlyHint: true
connecteam_get_jobOne job by id, with its sub-jobs, assignments and location.No findings
Why it is in this group
- The name "connecteam_get_job" says "get": a word for reading.
Description, as the server wrote it One job by id, with its sub-jobs, assignments and location. GET /jobs/v1/jobs/{jobId}.
Annotations the server declares
- title: Get job
- readOnlyHint: true
connecteam_get_shiftOne shift of a scheduler by its id, with assignments, statuses, breaks, notes and tasks.No findings
Why it is in this group
- The name "connecteam_get_shift" says "get": a word for reading.
Description, as the server wrote it One shift of a scheduler by its id, with assignments, statuses, breaks, notes and tasks. GET /scheduler/v1/schedulers/{schedulerId}/shifts/{shiftId}.
Annotations the server declares
- title: Get shift
- readOnlyHint: true
connecteam_get_timesheet_totalsPayroll-ready timesheet totals of a time clock for a date range (at most 45 days, Connecteam's limit): per user and day, total/work/paid-break/unpaid-break hours (decimal), approve…No findings
Why it is in this group
- The name "connecteam_get_timesheet_totals" says "get": a word for reading.
Description, as the server wrote it Payroll-ready timesheet totals of a time clock for a date range (at most 45 days, Connecteam's limit): per user and day, total/work/paid-break/unpaid-break hours (decimal), approved/submitted/locked flags and pay items by pay rule (with pay rates when defined). Filter by users, groups, jobs or approval state. GET /time-clock/v1/time-clocks/{timeClockId}/timesheet.
Annotations the server declares
- title: Get timesheet totals
- readOnlyHint: true
connecteam_list_form_submissionsList the submissions of one form: who submitted and when, the answers and the manager fields (status, owner, notes).No findings
Why it is in this group
- The name "connecteam_list_form_submissions" says "list": a word for reading.
Description, as the server wrote it List the submissions of one form: who submitted and when, the answers and the manager fields (status, owner, notes). Filter by submitting users and time window. GET /forms/v1/forms/{formId}/form-submissions.
Annotations the server declares
- title: List form submissions
- readOnlyHint: true
connecteam_list_formsList forms (checklists, inspections, reports) with their questions.No findings
Why it is in this group
- The name "connecteam_list_forms" says "list": a word for reading.
Description, as the server wrote it List forms (checklists, inspections, reports) with their questions. Filter by name or creation date. GET /forms/v1/forms.
Annotations the server declares
- title: List forms
- readOnlyHint: true
connecteam_list_jobsList jobs (the work items shifts and time are tracked against): id, title, code, color, description, GPS/geofence, assigned users/groups, parent job and sub-jobs, and the scheduler…No findings
Why it is in this group
- The name "connecteam_list_jobs" says "list": a word for reading.
Description, as the server wrote it List jobs (the work items shifts and time are tracked against): id, title, code, color, description, GPS/geofence, assigned users/groups, parent job and sub-jobs, and the schedulers/time clocks (instance ids) they belong to. GET /jobs/v1/jobs.
Annotations the server declares
- title: List jobs
- readOnlyHint: true
connecteam_list_schedulersList the job schedulers (schedules) in the account with their id, name, time zone and archived state.No findings
Why it is in this group
- The name "connecteam_list_schedulers" says "list": a word for reading.
Description, as the server wrote it List the job schedulers (schedules) in the account with their id, name, time zone and archived state. The scheduler id is needed to list or create shifts. GET /scheduler/v1/schedulers.
Annotations the server declares
- title: List schedulers
- readOnlyHint: true
connecteam_list_shiftsList shifts of one scheduler in a time window (one row per assigned user, as Connecteam's V1 endpoint returns them): title, start/end (Unix seconds), time zone, assigned user ids, …No findings
Why it is in this group
- The name "connecteam_list_shifts" says "list": a word for reading.
Description, as the server wrote it List shifts of one scheduler in a time window (one row per assigned user, as Connecteam's V1 endpoint returns them): title, start/end (Unix seconds), time zone, assigned user ids, open-shift spots, job, location, published state, statuses, breaks, notes and shift tasks. Filter by assigned users, job, open or published. GET /scheduler/v1/schedulers/{schedulerId}/shifts.
Annotations the server declares
- title: List shifts
- readOnlyHint: true
connecteam_list_task_boardsList the quick-task boards in the account (id, name, archived).No findings
Why it is in this group
- The name "connecteam_list_task_boards" says "list": a word for reading.
Description, as the server wrote it List the quick-task boards in the account (id, name, archived). The board id is needed to list or create tasks. GET /tasks/v1/taskboards.
Annotations the server declares
- title: List task boards
- readOnlyHint: true
connecteam_list_task_labelsList the labels of a task board (id, name, color), for filtering tasks or labelling a new one.No findings
Why it is in this group
- The name "connecteam_list_task_labels" says "list": a word for reading.
Description, as the server wrote it List the labels of a task board (id, name, color), for filtering tasks or labelling a new one. GET /tasks/v1/taskboards/{taskBoardId}/labels.
Annotations the server declares
- title: List task labels
- readOnlyHint: true
connecteam_list_tasksList tasks on a task board: title, assigned user ids, status (draft/published/completed), start and due time (Unix seconds), labels, sub-tasks and description.No findings
Why it is in this group
- The name "connecteam_list_tasks" says "list": a word for reading.
Description, as the server wrote it List tasks on a task board: title, assigned user ids, status (draft/published/completed), start and due time (Unix seconds), labels, sub-tasks and description. Filter by status, users, labels or task ids. GET /tasks/v1/taskboards/{taskBoardId}/tasks.
Annotations the server declares
- title: List tasks
- readOnlyHint: true
connecteam_list_time_activitiesClock-in/clock-out records of a time clock for a date range (at most 31 days per call), grouped by user: worked shifts (start/end, job, sub-job, notes, auto clock-out), manual brea…No findings
Why it is in this group
- The name "connecteam_list_time_activities" says "list": a word for reading.
Description, as the server wrote it Clock-in/clock-out records of a time clock for a date range (at most 31 days per call), grouped by user: worked shifts (start/end, job, sub-job, notes, auto clock-out), manual breaks and time off. Filter by users, jobs or activity type. GET /time-clock/v1/time-clocks/{timeClockId}/time-activities.
Annotations the server declares
- title: List time activities
- readOnlyHint: true
connecteam_list_time_clocksList the time clocks in the account (id, name, archived).No findings
Why it is in this group
- The name "connecteam_list_time_clocks" says "list": a word for reading.
Description, as the server wrote it List the time clocks in the account (id, name, archived). The time clock id is needed for time activities and timesheets. GET /time-clock/v1/time-clocks.
Annotations the server declares
- title: List time clocks
- readOnlyHint: true
connecteam_list_time_off_policy_typesList time-off policy types (e.g.No findings
Why it is in this group
- The name "connecteam_list_time_off_policy_types" says "list": a word for reading.
Description, as the server wrote it List time-off policy types (e.g. Vacation, Sick) and their policies with unit (hours/days) and accrual type. Needs the HR & Skills hub. GET /time-off/v1/policy-types.
Annotations the server declares
- title: List time-off policy types
- readOnlyHint: true
connecteam_list_time_off_requestsList time-off requests overlapping a date range (at most 365 days): user, policy type, dates/times, all-day flag, status (approved/pending/denied), notes, approving manager and, fo…No findings
Why it is in this group
- The name "connecteam_list_time_off_requests" says "list": a word for reading.
Description, as the server wrote it List time-off requests overlapping a date range (at most 365 days): user, policy type, dates/times, all-day flag, status (approved/pending/denied), notes, approving manager and, for approved requests, the amount deducted. Connecteam returns only approved requests unless statuses is given. Needs the HR & Skills hub. GET /time-off/v1/requests.
Annotations the server declares
- title: List time-off requests
- readOnlyHint: true
connecteam_list_usersList employees (users): name, email, phone, user type (user/manager/owner), archived state, smart groups, custom fields and last login.No findings
Why it is in this group
- The name "connecteam_list_users" says "list": a word for reading.
Description, as the server wrote it List employees (users): name, email, phone, user type (user/manager/owner), archived state, smart groups, custom fields and last login. Use it to map the user ids in shifts, time activities, timesheets, time off and tasks to names. Kiosk codes and device ids are never returned. GET /users/v1/users.
Annotations the server declares
- title: List users
- readOnlyHint: true
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.7.3. Values in angle brackets are yours to fill in.
claude mcp add --transport http connecteam https://connecteam.usefulapi.io/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__connecteam__connecteam_get_account",
"mcp__connecteam__connecteam_list_users",
"mcp__connecteam__connecteam_list_schedulers",
"mcp__connecteam__connecteam_list_shifts",
"mcp__connecteam__connecteam_get_shift",
"mcp__connecteam__connecteam_list_time_clocks",
"mcp__connecteam__connecteam_list_time_activities",
"mcp__connecteam__connecteam_get_timesheet_totals",
"mcp__connecteam__connecteam_list_jobs",
"mcp__connecteam__connecteam_get_job",
"mcp__connecteam__connecteam_list_time_off_policy_types",
"mcp__connecteam__connecteam_list_time_off_requests",
"mcp__connecteam__connecteam_list_task_boards",
"mcp__connecteam__connecteam_list_tasks",
"mcp__connecteam__connecteam_list_task_labels",
"mcp__connecteam__connecteam_list_forms",
"mcp__connecteam__connecteam_list_form_submissions"
],
"ask": [],
"deny": [
"mcp__connecteam__connecteam_create_shift",
"mcp__connecteam__connecteam_create_task"
]
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as connecteam. Review it before you use it.