developer-toolsapi_key

Connecteam

Connecteam is a comprehensive workforce management platform designed to streamline operations, enhance communication, and improve HR processes for deskless teams.

Verdict

Connecteam is a workforce management platform for deskless teams. This MCP exposes 15 tools that let you create and archive users, pull custom field definitions, retrieve form schemas, list jobs from the scheduler, and access team chat threads. Most useful for ops managers syncing employee data across systems, HR admins auditing custom fields before a migration, or team leads who need to surface shift schedules and form responses without opening another tab. Requires an API key from your Connecteam account settings; chat retrieval only works if you're on the Expert plan.

Common use cases

  • Bulk onboard new hires from a spreadsheet
  • Audit custom fields before a data migration
  • Pull shift schedules into a planning doc
  • Archive offboarded users in one command
  • Retrieve form responses for compliance review

Integration

Vendor
Connecteam
Category
developer-tools
Auth
API_KEY
Tools
15
Composio slug
connecteam

Tools

  • Archive Users

    Tool to archive one or more users by their unique ids. use when you need to deactivate users without deleting their records.

  • Create Users

    Tool to create multiple users in connecteam. use when you need to add several staff or admin accounts at once.

  • Generate Upload URL

    Tool to generate a pre-signed url for uploading a file. use when you need a secure, time-limited url prior to file upload.

  • Get Chat

    Tool to retrieve chat conversations. use when you need to list all team chats/channels after confirming your communications hub is on expert plan.

  • Get Custom Field Categories

    Tool to retrieve all custom field categories. use when you need to list or filter custom field categories in your connecteam account.

  • Get Custom Fields

    Tool to retrieve all custom fields associated with the account. use when you need to filter, sort, or page through custom fields after authentication.

  • Get Forms

    Tool to retrieve all form definitions from connecteam. use when you need to list all existing forms after enabling the forms api.

  • Get Jobs

    Tool to retrieve a list of job objects relevant to a specific instance id. use after confirming scheduler or time clock instance id when you need to filter and page through jobs.

  • Get Performance Indicators

    Tool to retrieve the list of performance metric indicators. use when you need to list available performance indicators for data analysis. examples: "list performance metrics".

  • Get Policy Types

    Tool to retrieve available time-off policy types. use before filtering or creating time-off requests by policytypeid.

  • Get Publishers

    Tool to retrieve a list of all custom publishers. use when you need to list custom publishers after confirming api access.

  • Get Schedulers

    Tool to retrieve a list of job schedulers associated with the account. use after authentication when you need to enumerate all schedulers.

  • Get Smart Groups

    Tool to retrieve all smart groups associated with the account. use when you need to list all smart groups after authenticating with a valid api key.

  • Get Task Boards

    Tool to retrieve all task boards. use after authenticating with a valid api key to list available task boards.

  • Get Users

    Tool to retrieve a list of all users associated with your account. use when you need to fetch and filter user data.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and click Integrations, then find Connecteam under Developer Tools. 2. Click Connect and you'll see a prompt for your Connecteam API key. 3. Log into your Connecteam account, navigate to Settings > API, and generate a new key with read and write permissions for users, forms, and custom fields. 4. Paste the key into Switchy and click Authorize. 5. Once connected, open any Space and type '@Connecteam get users' to confirm the integration works—you should see a list of active users returned in the chat. 6. To invoke other tools, @mention Connecteam and describe what you need: archive a user by ID, pull all form definitions, or retrieve job schedules from a specific instance.

What teammates see: by default, memories from Connecteam are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Onboard New Employees

@Connecteam create users for the following people: Alice Johnson (alice@example.com, admin), Bob Lee (bob@example.com, staff), Carol Martinez (carol@example.com, staff). Set their status to active.
Open in a Space →

List All Forms

@Connecteam get all forms in our account and show me their names, IDs, and creation dates in a table.
Open in a Space →

Archive Offboarded Users

@Connecteam archive the users with IDs 12345, 67890, and 11223. Confirm when done.
Open in a Space →

Pull Custom Field Schema

@Connecteam get all custom fields and their categories, then summarize which fields are required versus optional.
Open in a Space →

Retrieve Job Schedules

@Connecteam get all jobs for instance ID abc123 and list the job titles, assigned users, and start times for the next seven days.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Connecteam list all custom fields in our account, grouped by category, so I can see what employee data we're tracking.

Output

Here's an illustrative summary of custom fields in your Connecteam account: **HR & Onboarding** (5 fields): Emergency Contact Name, Emergency Contact Phone, T-Shirt Size, Dietary Restrictions, Start Date. **Certifications** (3 fields): Forklift License Expiry, Food Handler Cert Number, CPR Training Date. **Payroll** (2 fields): Bank Account Number, Tax Filing Status. This example shows how the MCP retrieves structured employee metadata; actual field names and categories depend on your account configuration.

Notes

This example demonstrates read-only access to your custom field schema. Requires API key with read permissions for user data. Useful for auditing what employee attributes you're collecting before building workflows that reference these fields.

Prompt

@Connecteam create three new users: John Doe (john@example.com, admin role), Sarah Lee (sarah@example.com, staff), and Mike Chen (mike@example.com, staff).

Output

Created 3 users successfully: John Doe (ID: usr_8x7k2m, admin), Sarah Lee (ID: usr_9p4n1q, staff), Mike Chen (ID: usr_3r6t8w, staff). All accounts are active and invitation emails have been sent to their respective addresses. This illustrative response shows the MCP's batch user creation; actual user IDs and email delivery depend on your account settings and email configuration.

Notes

This write operation immediately provisions accounts and triggers invitation emails. Requires API key with user management permissions. Be cautious with bulk creation—typos in email addresses or role assignments can't be undone without manual cleanup or archiving users.

Prompt

@Connecteam pull all open jobs from our scheduler for the next 7 days and summarize which roles have the most unfilled shifts.

Output

Analyzing 47 scheduled jobs from your Time Clock instance (ID: inst_5k2m): **Warehouse Associate** has 12 unfilled shifts (Mon-Fri mornings), **Delivery Driver** has 8 gaps (Wed-Sat evenings), **Customer Service** has 3 openings (weekend afternoons). Most critical shortage is Warehouse Associate on Thursday 9am-5pm with zero assigned staff. This example illustrates how the MCP fetches job data and the AI synthesizes staffing gaps; actual job counts and role names reflect your scheduler configuration.

Notes

This synthesis example pairs the Get Jobs tool with AI reasoning to surface staffing risks. Requires your scheduler or time clock instance ID and API access to job data. Rate limits may apply if you're querying large date ranges or multiple locations.

Use-case deep-dives

Onboarding seasonal retail staff

When Connecteam MCP handles bulk seasonal hiring

A 12-person retail chain hiring 40 seasonal workers for holiday rush needs to create accounts, assign custom fields for location and shift preference, and archive them post-season. The Connecteam MCP wins here because Create Users and Archive Users handle batch operations in one call, and Get Custom Fields lets you validate location codes before assignment. The trade-off: if your onboarding includes document signing or training modules, you'll still need Connecteam's web UI for those workflows—this MCP only covers user provisioning and metadata. Use this when your seasonal hiring spikes above 20 people per quarter and you're tired of manual CSV imports.

Field team daily check-in review

When chat retrieval fits distributed team ops

A 6-person facilities management company with 30 field techs uses Connecteam for daily check-ins and incident reports. The operations manager wants to pull yesterday's chat threads into a standup summary without opening the mobile app. Get Chat works if you're on Connecteam's Expert plan and your comms hub is enabled—otherwise the tool returns empty. The MCP shines for low-frequency audits (weekly summaries, monthly compliance checks) but falls short if you need real-time alerting or message search across date ranges. If your team sends under 50 messages per day and you're already paying for Expert, this is a clean fit for end-of-week reporting.

Compliance form audit for construction sites

When form retrieval supports safety documentation

A 20-person construction firm runs daily safety checklists and incident forms across four active sites. The safety officer needs to verify which forms are deployed and pull submission counts for quarterly audits. Get Forms retrieves all form definitions after you enable the forms API in Connecteam settings, and you can cross-reference with Get Jobs to see which sites are using which templates. The limitation: this MCP doesn't fetch form submissions or attachments—only the form structure. Use this when you need to audit form coverage or clone templates across projects, not when you're investigating a specific incident that requires submission data.

Frequently asked

What does the Connecteam MCP let me do in Switchy?

The Connecteam MCP gives Switchy read and write access to your workforce management data — creating and archiving users, pulling custom fields and form definitions, retrieving chat conversations, and managing jobs tied to your scheduler or time clock. It's useful for teams that want AI to automate onboarding, pull shift data, or answer questions about employee records without opening the Connecteam dashboard.

Do I need admin access to connect Connecteam via API key?

Yes. Connecteam's API requires an admin-level API key to authenticate, which you generate inside your Connecteam account settings. The key grants full read-write access to users, forms, jobs, and custom fields, so only account admins should create and share it. Store the key in Switchy's secure credential vault; anyone on your Switchy workspace can then invoke the MCP without seeing the raw key.

Can the Connecteam MCP send messages in team chats?

No. The Get Chat tool retrieves existing conversations from your communications hub, but the MCP has no tool to post new messages or create channels. If you need AI to send announcements or reply in Connecteam chats, you'll have to use Connecteam's web interface or wait for the vendor to add a send-message endpoint to their API.

How is this different from using Connecteam's dashboard or API directly?

The MCP wraps Connecteam's REST API so Switchy's AI can call it in natural language — you ask "archive the three contractors who finished last week" instead of writing cURL commands. The trade-off is you're limited to the 15 tools Connecteam's MCP exposes; if you need an endpoint that isn't wrapped, you'll still need Postman or a custom script.

Who on my team should connect the Connecteam MCP?

Whoever owns your Connecteam admin account and is comfortable generating an API key. Once connected, any Switchy workspace member can invoke the MCP in threads, but only the connector can rotate or revoke the key. If your HR lead manages Connecteam day-to-day, have them connect it; if your ops manager handles integrations, delegate it there.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.