Connecteam MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Connecteam MCP or direct API to automate scheduling, manage shift assignments, track timesheets, and send team updates through natural language.

Connecteam logoConnecteam
Api Key

Connecteam is a workforce management platform for deskless teams, streamlining operations, HR, and team communication. It helps businesses save time by automating scheduling, time tracking, and staff engagement tasks.

36 Tools

Try Connecteam now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Connecteam
Try asking
TOOLS

Supported Tools

Every Connecteam action and event your agent gets out of the box.

Archive Users

Tool to archive one or more users by their unique IDs.

Create Daily Note

Create a daily note for qualified users or groups.

Create Jobs

Create parent jobs or add sub-jobs beneath existing parent jobs.

Create Shifts

Create shifts without notifications by default.

Create Time Activities

Create shifts or breaks, optionally splitting existing shifts around breaks.

Create Users

Tool to create multiple users in Connecteam.

Delete Geofence

Delete one geofence and automatically verify its absence.

Delete Job

Delete a standalone job by ID.

Delete Shift

Delete one shift from a scheduler.

Delete Time Activity

Delete one shift or manual-break activity from a time clock.

Generate Upload URL

Tool to generate a pre-signed URL for uploading a file.

Get Chat

Retrieve a page of chat conversations, including team chats and channels.

Get Custom Field Categories

Tool to retrieve all custom field categories.

Get Custom Fields

Retrieve custom fields associated with the account, with options to filter, sort, and page through results.

Get Form

Retrieve one form definition, including its questions and settings.

Get Forms

Tool to retrieve all form definitions from Connecteam.

Get Form Submissions

Retrieve submissions for a form, optionally filtered by user or submit time.

Get Geofences

List all geofences configured for a time clock.

Get Jobs

Tool to retrieve a list of job objects relevant to a specific instance ID.

Get Pay Rates

Retrieve effective user pay rates over a required date range.

Get Performance Indicators

Tool to retrieve the list of performance metric indicators.

Get Policy Balances

Retrieve a page of user balances for a time-off policy type.

Get Policy Types

Tool to retrieve available time-off policy types.

Get Publishers

Retrieve a page of custom publishers associated with the account.

Get Schedulers

Tool to retrieve a list of job schedulers associated with the account.

Get Shifts

List shifts in a scheduler for a required Unix-time window.

Get Smart Groups

Tool to retrieve all smart groups associated with the account.

Get Task Boards

Tool to retrieve all task boards.

Get Time Activities

Retrieve shifts, manual breaks, and time off grouped by user.

Get Time Off Requests

Retrieve time-off requests overlapping a required date range.

Get Timesheet Totals

Retrieve payroll-oriented total hours for one time clock.

Get Users

Retrieve and filter a page of users associated with the account.

List Me

Tool to retrieve account information including company name and company ID.

Update Job

Update a standalone job or sub-job by ID.

Update Shifts

Update shifts; notifyUsers defaults true and may notify users for published shifts.

Update Users

Update up to 25 users, identifying every item by user ID or phone number.

SETUP GUIDE

Connect Connecteam MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["connecteam"],
  mcp: true,
});
Create a session scoped to Connecteam and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Archive all inactive users from the staff directory",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Connecteam request
SETUP GUIDE

Connect Connecteam API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["connecteam"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Connecteam
3

Run Connecteam tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Archive all inactive users from the staff directory" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Connecteam tool calls through the session, and print the final answer

Why Use Composio?

AI Native Connecteam Integration

  • Supports both Connecteam MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Connecteam data

Managed Auth

  • Built-in API key handling with secure storage
  • Central place to manage, scope, and revoke Connecteam access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Connecteam
  • Scoped, least privilege access to Connecteam resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Connecteam.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Connecteam tool your agent needs.Free to start.

Start building