Use
COMPOSIOFOR YOU
Give Claude, Codex, or any harness secure access to 1700+ tools
CLI
One command to add tools and auth to your coding agent
Build
DEVELOPER PLATFORM
SDKs, tools, and auth for agents and backend apps
MCP GATEWAY
One managed MCP endpoint for all your tools and agents
ENTERPRISE
SSO, governance, and audit controls for deploying agents org-wide
Features
TRIGGERS
Start background agents from events across your connected apps
FIREWALLNEW
Blocks instructions hidden in tool results before your agent reads them
INSTANTNEW
Audio, video, search, browser and data tools, with no keys to manage
OPTIMIZATION
Lower cost per completed task with optimised tools and skills
FOR AGENTS
CLAUDE CODEX OPENCLAW CURSOR HERMES
BUILT FOR
OFFICE WORK SALES MARKETING PRODUCT & DESIGN CUSTOMER SUPPORT ENGINEERING HR & RECRUITING FINANCE & OPS E-COMMERCE CONTENT & MEDIA IT & SECURITY
ALL USE CASES
DOCS

Deputy MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Deputy MCP or direct API to manage employee records, review schedules, track timesheets, and handle leave through natural language.

Get started for free Get a demo

Deputy

Oauth2

Deputy is a workforce management platform for scheduling, employees, timesheets, leave, and workplace locations. It helps teams simplify staff planning, time tracking, and daily workforce operations.

247 Tools

Try Deputy now

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

TOOL ROUTER PLAYGROUND

Deputy

Enter ↵

Try asking

TOOLS

Supported Tools

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

Add resource comment

Add comment text to one Deputy resource record.

Apply Timesheet Operation

Apply a non-clock timesheet operation: update for self or supervised timesheets, dispute or IP amend for self, and approve or discard for supervised timesheets.

Bulk create or update resource records

Create or update multiple records of one resource type.

Copy Company Roster Template

Create a roster-template copy for a Deputy company from the supplied template data.

Create Employee Leave

Create a new employee leave record.

Create Employee Unavailability

Create a recurring unavailability record for a specific supervised employee.

Create or replace resource record

Create a resource record, or fully replace the matching record when the supplied data identifies one.

Create resource record

Create an Employee, Leave, OperationalUnit, Roster, or Timesheet record from typed agent-facing fields.

Decline Gamingfy Item

Decline the Gamingfy item identified by the supplied request object, changing its state.

Delete My Memo Comment

Delete a comment from the specified memo.

Delete My Preference

Delete one preference for the connected Deputy user by preference key.

Delete My To-Do Item

Delete a to-do item belonging to the connected user by its numeric ID.

Delete My Token

Invalidate the Deputy token identified by its documented token ID or token value.

Delete resource comment

Permanently delete one comment from a Deputy resource record.

Delete resource record

Permanently delete an Employee, Leave, OperationalUnit, Roster, or Timesheet record by ID.

Delete Department

Permanently delete the Deputy department identified by department ID.

Delete Contracted-Hours Template

Permanently delete an employee contracted-hours template by template ID.

Delete Employee Invitations

Delete the employee invitation data selected by Deputy's zero-input invitation endpoint; deletion is irreversible.

Delete Roster Template

Permanently delete a Deputy roster template by template ID.

Delete Unavailability

Permanently delete a self or supervised employee unavailability record by ID.

Find matching resource record

Find the closest existing record matching a partial typed record before deciding whether to create or update it.

Get My Workplace Setup

Return the connected Deputy user's workplaces, departments, role, permissions, and setup capabilities without contact or address details.

Get Department Weather

Get current weather or weather for a specified date for one Deputy department.

Get Location Weather

Get current weather or weather for a specified date for locations in one Deputy company.

Get OAuth Identity

Get OAuth Identity.

List My Colleagues

List colleagues visible to the connected Deputy user.

Count My Colleagues

Return the number of colleagues visible to the connected Deputy user.

List My Contact Addresses

List contact addresses available to the connected Deputy user.

List All My Contact Addresses

List all contact addresses available to the connected Deputy user.

Get My Emergency Contact Addresses

Get emergency contact addresses for the connected Deputy user.

Get Subordinate Contact Addresses

Get contact addresses for employees subordinate to the connected Deputy user.

Get Company Subordinate Contact Addresses

Get subordinate contact addresses for the specified Deputy company.

Get Department

Get a Deputy department by its department ID.

Get My Feed By Range

Get feed records for the connected Deputy user over the supplied start-to-end interval.

Get My Feed By Date

Get feed records for the connected Deputy user on the specified date.

Get My Feed Summary By Range

Get a summary of the connected Deputy user's feed over the supplied start-to-end interval.

Get My Leave By Setup

Get leave setup data for the connected Deputy user.

List All Locations

List all locations available to the connected Deputy account.

Get Locations By Company

Get location records for the specified Deputy company.

List Location Kiosk Authentication Modes

List the kiosk authentication modes allowed for locations in the specified Deputy company.

Get Location By Coordinates

Get Deputy location data for the specified latitude and longitude.

Get Flagged Location By Coordinates

Get Deputy location data for the supplied coordinates using the specified location lookup flag.

List My Memos

List memos available to the connected Deputy user.

Get My Memo

Get a Deputy memo by its memo ID.

Get Company Memos

Get memos for a Deputy company by company ID.

Get Memo Reactions

Get reactions for the specified Deputy record type and record ID.

List My Read Memos

List memos marked as read for the connected Deputy user.

Get My Memo Summary

Get memo summary data for the connected Deputy user.

Get Team Memos

Get memos for a Deputy team by team ID.

List My Unread Memos

List unread memos for the connected Deputy user.

Get User Memos

Get memos for a Deputy user by user ID.

List My Notifications

List notifications visible to the connected Deputy user.

Check My NPS Eligibility

Return whether the connected Deputy user can submit an NPS response.

Get My Photo

Get the connected Deputy user's photo.

Get My Preference

Get one preference for the connected Deputy user by its preference key.

List My Roster Bids

List roster bids available to the connected Deputy user.

Get My Roster

Get one roster record available to the connected Deputy user by roster ID.

Get My Roster Offer Recommendation

Get the offer recommendation for a roster by roster ID.

Get My Roster Offer Status

Get the offer status for a roster by roster ID.

Get My Roster By Date Range

Get the connected user's roster records between the specified start and end dates.

List My Open Rosters

List open roster records available to the connected Deputy user.

Get Open Rosters By Date Range

Get open roster data between the supplied dates, waiting up to the specified maximum wait time.

Check Roster Publish Allowance

Return whether the connected user may publish the specified number of rosters.

Get My Roster Publish Count

Return the publish-related roster count for the connected Deputy user.

List My Rosters From Timestamp

List the connected user's roster records from a start timestamp using the specified ordering direction and result limit.

Get My Setup Apps

Get Deputy setup app configuration available to the connected user.

Get My Gamingfy Setup

Get Gamingfy setup data for the selected list or decline operation.

List States And Countries

List Deputy's supported countries and their states for setup and address selection.

Get My Support Access

Get Deputy support-access status or configuration for the connected user's account.

List My Tasks

List tasks available to the connected Deputy user.

List My Completed Tasks

List completed tasks available to the connected Deputy user.

Get My Department Tasks

Get department-related task data available to the connected Deputy user.

Get My Department Tasks By Date

Get department-related task data for the connected Deputy user on the supplied date.

Check Timesheet Approval Allowance

Return the approval-allowance result for the requested number of timesheets.

List My Timesheets By Range

List the connected user's timesheets between the specified start and end values.

List My Timesheets From Timestamp

List the connected user's timesheets from a start timestamp using the specified ordering direction and result limit.

List My To-Do Items

List to-do items assigned to the connected Deputy user.

List My Tokens

List Deputy token records available to the connected user.

List My Training Records

List training records available to the connected Deputy user.

List My Unavailability By Date Range

List the connected Deputy user's unavailability records between the specified start and end dates.

Get My Widget Information

Get Deputy widget metadata available to the connected user.

Get My Widget Run Data

Get run-related widget data available to the connected Deputy user.

Get Widget Run

Get run information for the specified Deputy widget ID.

Get resource record at time

Get one Deputy resource record as it existed at the specified Unix timestamp.

Get resource field metadata

Get Deputy's field metadata for the selected resource type.

Get resource history

Get the change history for one Deputy resource record.

Get resource record

Get one Company, Employee, Leave, OperationalUnit, Roster, or Timesheet record by its numeric ID.

Get Roster Recommendation

Get a roster recommendation for the connected employee or supervised employees.

Get Roster Swap Details

Get swap details for a roster belonging to the connected employee or supervised employees.

Get Bulk Location Settings Job Result

Get the check result for a Deputy bulk company-settings job by job ID.

Get Location Settings

Get the configured settings for a Deputy company or location by company ID.

List Simplified Locations

Get Deputy's simplified location list for lightweight location selection.

Get Company Timezone

Get the timezone configured for the connected user's Deputy company.

Check Department

Return Deputy's untyped department-check object for the specified department ID.

Get Department Location

Return Deputy's untyped department-location lookup object for the specified ID.

List Supervised Employees

Get full Deputy records for all employees visible to the connected supervisor.

Get Employee

Get the Deputy employee record with the specified employee ID.

Get Employee Related Resource Data

Get data for the specified employee-related resource category through Deputy's generic legacy route.

Get Employee Contracted Hours

Get contracted-hours information for the specified Deputy employee.

Get Employee HR Onboarding

Get HR onboarding information for the specified Deputy employee.

Get Employee Payroll Connection

Read payroll connection information for the specified Deputy employee.

Get Employee Payroll Sync Information

Read payroll synchronization information for the specified employee without starting a sync.

Get Employee Login Management State

Read login-management information for the specified employee without changing login access.

Get Employee Validation Result

Get Deputy's read-only validation result for the specified employee.

List Contracted-Hours Templates

List the contracted-hours templates available for supervised employees.

Get Employee Demo Data

Get the employee demo result exposed by Deputy's legacy supervisor API.

Get Employee Invitation Information

Get the invitation information returned by Deputy's zero-input employee invitation endpoint.

Get Real Employee Records

Get the employee subset Deputy's legacy API classifies as real employees.

Count Real Employees

Return the count of employees Deputy's legacy API classifies as real employees.

Get Employee Role Management Data

Read the employee-role management data exposed by Deputy; this operation does not change roles.

Get Employee Shift Information

Get current shift information for an employee, optionally broadened across all companies by the required scope flag.

Get Roster Recommendation Status

Get the current recommendation status for a Deputy roster by roster ID.

Get Employee Leave Information

Get Deputy leave information for the specified employee.

Get Employee Leave Setup Information

Get leave information for an employee using Deputy's required leave setup selector.

List Recent Rosters

List Deputy rosters from the previous 12 hours through the next 36 hours.

Get Rosters by Date

Get Deputy roster data for the specified date.

Get Company Rosters by Date

Get roster data for a Deputy company on the specified date.

List Company Rosters by Date

Get a paginated roster result for a Deputy company and date, with an explicit selector for including open rosters.

Get Roster Bids

Get bids for a roster by roster ID.

Get Roster Autobuild Job Result

Get the status or result of an automatic Deputy roster-build job by job key.

Get Roster Autofill Job Result

Get the status or result of an automatic Deputy roster-fill job by job key.

Get Roster Manager Notification Information

Get Deputy's manager-notification information for the specified roster; this GET operation does not send a notification.

Get Pending Roster Swap Approval Details

Get pending-approval swap details for a roster by roster ID.

List Roster System Templates

List Deputy roster system templates using the required provider-defined numeric mode.

Get Bulk Timesheet Job Result

Get the check result for a Deputy bulk timesheet job by job ID.

Get Employee Timesheet by Date

Get Deputy timesheet information for an employee on the specified date.

Get Employee Unavailability

Get Deputy unavailability information for the specified employee.

Get Timesheet Details

Get detailed timesheet data for the connected employee or supervised employees.

Get Timesheet History

Get timesheet change history for the connected employee or supervised employees.

Get Timesheet Setup

Get timesheet setup information for the connected employee or supervised employees.

List Companies and Locations

List Deputy companies, workplaces, and payroll entities, or return one company when company_id is provided.

List Company Roster Templates

List roster templates for a Deputy company without changing them.

List Employees

Return one page of Deputy employees, or one exact employee when employee_id is provided, without contact, address, payroll, tax, bank, birth, photo, or emergency-contact fields.

List Gamingfy Items

List Gamingfy setup items without changing their state.

List Leave Records

Return one page of employee leave records, or one leave record when leave_id is provided, without reasons, comments, medical or attachment data, pay details, or creator profiles.

List Operational Units

Return one page of Deputy operational units (areas or departments), or one unit when operational_unit_id is provided.

List resource comments

List comments attached to one Deputy resource record.

List resource records

List raw Company, Employee, Leave, OperationalUnit, Roster, or Timesheet records.

List Roster Shifts

Return one page of scheduled Deputy roster shifts, or one exact shift when roster_id is provided, without comments, costs, creator profiles, or recursive metadata.

List Roster Swaps

List roster swaps in a date range for the connected employee or supervised employees.

List Timesheets

Return one page of timesheet records, or one timesheet when a timesheet ID is provided.

Search My Colleagues

Search colleague records visible to the connected Deputy user using a Deputy query object.

Create or update Contactaddress

Create or update contact-address data for the connected Deputy user.

Update My Emergency Contact Address

Update emergency contact information for the connected Deputy user.

Query Locations Pending Approval

Query locations awaiting approval for the connected Deputy user using a Deputy query object.

Update My Memo Feed

Apply provider-defined changes to the connected Deputy user's memo or newsfeed state.

Add My Memo Comment

Add a comment to the specified memo for the connected user.

Update Company Memo

Apply the supplied memo change for the specified Deputy company.

Update My Memo Summary

Update memo summary state for the connected Deputy user using the supplied request values.

Update Team Memo

Apply the supplied memo change for the specified Deputy team.

Update User Memo

Apply the supplied memo change for the specified Deputy user.

Create or update Nps

Create or update the connected Deputy user's Net Promoter Score response.

Postpone My NPS Response

Postpone the connected Deputy user's NPS response or prompt.

Update My Photo

Update the connected Deputy user's named photo using the supplied photo request body.

Update My Preference

Update the connected Deputy user's named preference using the supplied preference value.

Update My Support Access

Change Deputy support access for the connected user's account using the supplied support-access setting.

Request My Roster Bid

Create pending bids for the connected employee on eligible published open rosters that require approval.

Withdraw My Roster Bid

Change the connected employee's pending bids on the specified rosters to withdrawn.

Offer My Roster

Create an offer for the specified roster record using the supplied offer details.

Cancel My Roster Offer

Cancel the existing offer for the specified roster record.

Update My Roster Swap

Request, cancel, accept, recommend, decline, or decline all for the specified roster swap.

Claim My Open Rosters

Assign eligible published open rosters that do not require approval to the connected employee, closing those openings.

Create Workplace

Create a new workplace in the connected Deputy account using the supplied workplace details.

Resolve Address And Timezone From Coordinates

Resolve an address and timezone from the supplied geographic coordinates without changing Deputy data.

Resolve Coordinates And Timezone From Address

Resolve geographic coordinates and a timezone from the supplied address without changing Deputy data.

Send Email To Customer Experience

Immediately send the supplied email to Deputy Customer Experience.

Run My Setup SF Operation

Submit setup data to Deputy's legacy setup route and return its untyped result object.

Validate Workplace

Validate the supplied Deputy workplace details and return the result without changing the workplace.

Update My Task State

Apply provider-defined changes to the connected Deputy user's task state.

Update My Task

Update the specified task for the connected Deputy user using the supplied request values.

Update My Completed Tasks

Apply the supplied completion change to tasks for the connected Deputy user.

Update My Department Tasks

Apply the supplied department-task change for the connected Deputy user.

Update My Department Tasks By Date

Apply the supplied department-task change for the connected Deputy user on the specified date.

Create or update Todo

Create or update a to-do item for the connected Deputy user.

Create or update Unavail

Create or update an unavailability record for the connected Deputy user.

Update Settings for All Locations

Update the week-start setting across all Deputy locations.

Update Location

Update documented fields for a Deputy company or location by ID.

Archive Location

Archive the selected Deputy company or location so it is no longer active; verify the company ID before running.

Cascade Location Settings

Update documented settings for a Deputy company and cascade those values to eligible child records.

Delete Location

Permanently delete the Deputy company or location identified by company ID; verify the target before running.

Set Location Google Place ID

Set or replace the Google Place ID associated with a Deputy company or location.

Update Location Settings

Update the week-start setting for a Deputy company or location by company ID.

Update Departments for Location

Update the collection of department records associated with the specified Deputy location and return Deputy's untyped result object.

Update Department

Update a Deputy department by ID, supplying its location and name and optionally its address, payroll export name, display order, or area type.

Create Employee

Create a Deputy employee using the supplied name, location, and optional employment details.

Amend Employee ABP Data

Update employee data through Deputy's legacy amendment route and return its untyped result object.

Update Employee

Update the phone value for an existing Deputy employee by employee ID.

Reactivate Employee

Reactivate a terminated Deputy employee, returning the employee to active status.

Update Employee Related Resource

Apply the supplied object to the selected employee-related category: memo, roster, timesheet, journal, leave, or employee availability.

Update Employee Contracted Hours

Apply Deputy's documented contracted-hours mutation to an existing employee.

Delete Employee Account

Permanently delete the selected employee's Deputy account; unlike termination, this removes the account record and cannot be undone.

Update Employee HR Onboarding

Assign an HR onboarding record ID to the specified Deputy employee.

Synchronize Employee Payroll Data

Run Deputy's documented HR payroll synchronization operation for the specified employee; verify payroll inputs before running.

Invite Employee to Deputy

Invite the selected employee to Deputy, sending a one-way external invitation that cannot be recalled; verify the employee ID and invitation details first.

Update Employee Photo

Update the selected employee's photo using Deputy's documented photo object.

Reset Employee Two-Factor Authentication

Reset the selected employee's two-factor authentication, invalidating the current second-factor setup so it must be configured again.

Send Employee Login Communication

Send Deputy's login communication to the selected employee; the external message cannot be recalled.

Send Employee Account Reset

Send the selected employee Deputy's account-reset communication; this security-sensitive external message cannot be recalled.

Set Employee Award from Library

Apply an award from Deputy's library to selected employment agreements; if no agreement IDs are supplied, Deputy updates all agreements for the employee.

Set Employee Award from Template

Apply a proven Deputy award contract template to selected employee agreements.

Terminate Employee

Terminate the specified Deputy employee.

Update Contracted-Hours Template

Apply Deputy's documented mutation to a contracted-hours template using the supplied template object.

Update Contracted-Hours Template

Update a Deputy contracted-hours template by template ID using the supplied documented fields.

Create Employee

Create one or more Deputy employees with each employee's first name, last name, and location ID.

Process Employee Invitation

Process an employee invitation using Deputy's documented invitation payload; use validation first when the payload is untrusted.

Search Supervised Employees

Search supervised employees using Deputy's employee query filters and return matching employee records.

Reset Employee Gender Data

Reset employee gender data using Deputy's documented reset object; verify the target data before running.

Validate Employee Data

Validate employee data before creating or updating an employee; this check does not change workforce records.

Update Roster Recommendations

Update employee recommendations for the specified roster using the supplied object and return Deputy's untyped result object.

Notify Recommended Employee

Send an immediate, non-recallable workforce notification to the selected recommended employee for a roster; verify the roster and notification details first.

Notify All Recommended Employees

Send immediate, non-recallable workforce notifications to every recommended employee for a roster; verify the roster and notification details first.

Reset Roster Recommendations

Reset recommendations for a roster.

Create or Update Roster Timesheet Data

Create or update Deputy's documented roster-timesheet record using the supplied relationship object.

Manage Employee Leave

Update leave-management state for the leave record or request identified in the supplied object and return Deputy's untyped result object.

Create or Update Roster

Create or update a Deputy roster using the supplied documented roster object.

Autobuild Roster

Start an asynchronous job that creates unpublished Deputy shifts for selected areas and dates using staffing, coverage, or historical demand.

Autobuild Roster from Agreed Hours

Create Deputy shifts from selected employees' agreed-hours profiles for specified areas, locations, and dates.

Autobuild Roster from GFE

Start Deputy's documented GFE-based automatic roster-build operation using the supplied inputs.

Autofill Roster

Start an asynchronous job that assigns candidate employees to selected open Deputy shifts using bounded search and optimization settings.

Cancel Roster Autofill

Cancel the roster autofill operation identified by the supplied Deputy cancellation object.

Check Roster Autobuild from Agreed Hours

Check or advance Deputy's documented roster autobuild-from-agreed-hours job using its job key and request object.

Check GFE Roster Autobuild

Check or advance Deputy's documented GFE-based roster-autobuild job using its job key and request object.

Copy Roster

Copy Deputy roster data using the supplied source and destination settings.

Copy Rosters in Batch

Copy multiple rosters in one request using the supplied source and destination settings; verify every roster target before running.

Discard Roster Changes

Discard the Deputy roster state selected by the supplied documented object; verify the target before running.

Publish Roster

Publish selected Deputy rosters or rosters across all locations, making the schedule externally visible.

Recalculate Timesheets in Bulk

Recalculate the selected timesheets in bulk; verify the timesheet selection and recalculation inputs before updating them.

End Employee Timesheet

Clock off an employee and end the selected active timesheet using Deputy's documented clock-off object.

Toggle Employee Timesheet Break

Toggle an employee timesheet between paused and resumed break states.

Start Employee Timesheet

Clock on an employee and start a timesheet using Deputy's documented clock-on object.

Submit My NPS Response

Submit a Net Promoter Score response for the connected Deputy user.

Set My Preference

Set the connected Deputy user's preference identified by key to the supplied value.

Create Company

Add a Deputy location with its workplace name, address, and optional workplace, timezone, parent-company, and payroll settings.

Create Department

Create a Deputy department from the supplied documented department fields.

Create Multiple Departments

Create multiple Deputy departments from the supplied documented department data.

Create Employee

Create a Deputy employee using the supplied documented employee fields.

Replace Employee Contracted Hours

Update contracted-hours details for an existing Deputy employee by employee ID; verify the employee and effective hours before running.

Create Contracted-Hours Template

Create a Deputy contracted-hours template using the supplied documented template object.

Validate Employee Data

Validate the supplied employee object through Deputy's legacy PUT validation route and return the validation result.

Replace resource record

Replace an existing Employee, Leave, OperationalUnit, Roster, or Timesheet record with a non-atomic safety check.

Replace Unavailability

Replace a self or supervised employee unavailability record by ID.

Save Company Roster Template

Save changes to roster-template data for a Deputy company.

Search resource records

Search one Deputy resource type with typed filters, sorting, offset pagination, and optional related-record expansion.

Set Employee Workplace Association

Associate an employee with a workplace or remove that relationship.

Set Memo Read State

Mark a memo log read or unread for the connected Deputy user.

Set Task Completion

Complete or restore a task belonging to the connected Deputy user.

Update resource record

Update an existing Employee, Leave, OperationalUnit, Roster, or Timesheet record using Deputy's documented complete resource schema.

SETUP GUIDE

Connect Deputy MCP Tool with your Agent

Install Composio

typescript

npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai

Install the Composio SDK and your agent framework

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: ["deputy"],
  mcp: true,
});

Create a session scoped to Deputy and read its MCP URL and headers

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: "List all employees currently on leave tomorrow and include their names and leave dates.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();

Pass the session's MCP URL and headers to your agent and run a Deputy request

SETUP GUIDE

Connect Deputy API Tool with your Agent

Install Composio

typescript

npm install @composio/core @composio/openai openai

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK

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: ["deputy"] });
const tools = await session.tools();

Initialize Composio with the OpenAI Responses provider and create a session scoped to Deputy

Run Deputy tools with your agent

typescript

let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all employees currently on leave tomorrow and include their names and leave dates." }],
});

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 Deputy tool calls through the session, and print the final answer

Why Use Composio?

AI Native Deputy Integration

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

Managed Auth

Built-in OAuth handling with automatic token refresh and rotation
Central place to manage, scope, and revoke Deputy 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 Deputy
Scoped, least privilege access to Deputy resources
Full audit trail of agent actions to support review and compliance

FRAMEWORKS

Use Deputy with any AI Agent Framework

Choose a Framework you want to connect Deputy with

ChatGPT

Use Deputy MCP with ChatGPT

Claude Cowork

Use Deputy MCP with Claude Cowork

Hermes

Use Deputy MCP with Hermes

Atomic Agent

Use Deputy MCP with Atomic Agent

Rolling this out across your team?

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

EXPLORE MCP GATEWAY

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Ashby

Api Key

Ashby is an applicant tracking system that handles job postings, candidate management, and hiring analytics.

7shifts

Api Key

7shifts is a restaurant team management platform for scheduling, time clocks, payroll, and team communication. It helps operators keep labor, shifts, and staff workflows organized in one place.

AI Ark

Api Key

AI Ark is a people and company intelligence platform with search, enrichment, and recruiting APIs. It helps teams find accurate contact data and discover hiring insights faster.

Async interview

Api Key

Async interview is an on-demand video interview platform for streamlined hiring. Candidates record responses on their schedule, so employers can review anytime.

FAQ

Frequently asked questions

Deputy requires connections to go through your own OAuth app. You register it once with Deputy, add its client ID and secret in the Composio dashboard, and from then on everyone connects by signing in to Deputy as usual. Composio handles the rest of the flow and the token refresh.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Deputy connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

When you connect a Deputy account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Deputy as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones Deputy lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your Deputy administrator may need to approve the app first, and you can revoke the access inside Deputy whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Deputy connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes Deputy tokens automatically, so day to day you do nothing. If you revoke access inside Deputy, or Deputy invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal Deputy use. Paid plans add higher limits and team features. Your Deputy plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Deputy accounts).

With Composio, you connect Deputy once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Deputy.It takes 30 seconds.

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

Start building

Deputy MCP server for AI agents and assistants

Try Deputy now

Supported Tools

Connect Deputy MCP Tool with your Agent

Install Composio

Create a session with MCP enabled

Connect your agent to the MCP server

Connect Deputy API Tool with your Agent

Install Composio

Create a Composio session

Run Deputy tools with your agent

Why Use Composio?

AI Native Deputy Integration

Managed Auth

Agent Optimized Design

Enterprise Grade Security

Use Deputy with any AI Agent Framework

ChatGPT

Claude Cowork

Hermes

Atomic Agent

Rolling this out across your team?

Explore Other Toolkits

Ashby

7shifts

AI Ark

Async interview

Frequently asked questions

Do I need my own Deputy developer credentials or OAuth app?

Can I use multiple toolkits together?

Is Composio secure with my Deputy account?

What if the API changes?

Does the agent act as me inside Deputy?

Which Deputy permissions does Composio get?

Can I use multiple Deputy accounts with Claude and ChatGPT?

What happens when my Deputy access expires or I revoke it?

Does using Deputy through Composio cost extra?

How is Composio different from the Deputy connectors already built into Claude and ChatGPT?

Start with Deputy.It takes 30 seconds.