Skip to content

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.

Deletes · 2

19 tools: 2 can delete or cancel things and 17 only read.

Scanned Oct 21, 2026

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/mcp

Tools

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/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.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.