Gusto MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Gusto MCP or direct API to review employee records, manage payroll data, track benefits, and query HR details through natural language.

Gusto logoGusto
Oauth2

Gusto is a payroll, benefits, and HR platform for small and medium businesses. It helps teams run payroll, manage people, and stay compliant with less busywork.

192 Tools

Try Gusto now

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

TOOL ROUTER PLAYGROUND
Gusto
Try asking
TOOLS

Supported Tools

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

Add Employees to Holiday Pay Policy

Tool to add employees to a company's holiday pay policy in Gusto.

Add Employees to Time Off Policy

Tool to add employees to a time off policy in Gusto.

Add People to Department

Tool to add employees and contractors to a department in Gusto.

Assign Pay Schedules

Tool to assign employees to pay schedules in Gusto.

Calculate Accruing Time Off Hours

Tool to calculate accruing time off hours for an employee based on hours worked and used in a pay period.

Create Admin

Tool to create a new admin for a Gusto company.

Create Time Sheet

Tool to create a time sheet for an employee or contractor in Gusto.

Create Company Bank Account

Tool to create a company bank account in Gusto.

Create Company Benefit

Tool to create a company benefit in Gusto.

Create company location

Tool to create a company location in Gusto.

Create Company Signatory

Tool to create a new signatory for a Gusto company.

Create Contractor

Tool to create an individual or business contractor in Gusto.

Create Contractor Bank Account

Tool to create a contractor bank account in Gusto.

Create Department

Tool to create a new department in a Gusto company.

Create Earning Type

Tool to create a custom earning type for a company in Gusto.

Create Employee

Tool to create a new employee in Gusto.

Create Employee Bank Account

Tool to create an employee bank account in Gusto.

Create Employee Benefit

Tool to enroll an employee in a company benefit in Gusto.

Create Employee Rehire

Tool to create an employee rehire in Gusto.

Create Employee Work Address

Tool to create an employee's work address in Gusto.

Create Employee YTD Benefit Amounts

Tool to create year-to-date benefit amounts from a different company for an employee.

Create flows

Tool to generate a link to access a pre-built workflow in Gusto white-label UI.

Create Garnishment

Tool to create a garnishment (employee deduction) in Gusto.

Create Historical Employee

Tool to create a historical employee in Gusto.

Create Holiday Pay Policy

Tool to create a holiday pay policy for a company in Gusto.

Create Job

Tool to create a job for an employee in Gusto.

Create job compensation

Tool to create a compensation for a job in Gusto.

Create Payroll General Ledger Report

Tool to create a general ledger report for a payroll with optional aggregation by job, department, or integration type.

Create Pay Schedule Assignment Preview

Tool to preview employee pay schedule assignment changes for a company.

Create Custom Report

Tool to create a custom report for a company with custom columns, groupings, and filters.

Create Employees Annual FICA Wage Report

Tool to generate an annual FICA wage report for all employees in a company over a specified year range.

Create Section 603 High Earner Status

Tool to create a Section 603 high earner status for an employee in Gusto.

Create Time Off Policy

Tool to create a time off policy in Gusto for a company.

Deactivate Earning Type

Tool to deactivate an earning type for a company.

Deactivate Time Off Policy

Tool to deactivate a time off policy in Gusto.

Delete Company Bank Account

Tool to disable a company bank account in Gusto.

Delete Company Holiday Pay Policy

Tool to delete a company's holiday pay policy in Gusto.

Delete Compensation

Tool to delete a compensation by its UUID.

Delete Contractor

Tool to delete a contractor from Gusto.

Delete Department

Tool to delete a department in Gusto.

Delete Employee

Tool to delete an onboarding employee from Gusto.

Delete Employee Bank Account

Tool to delete an employee bank account in Gusto.

Delete Employee Benefit

Tool to delete an employee benefit by its UUID.

Delete Employee Home Address

Tool to delete an employee's home address in Gusto.

Delete Employee Termination

Tool to delete an employee termination in Gusto.

Delete I-9 Authorization Document

Tool to delete an employee's I-9 verification document from Gusto.

Delete Job

Tool to delete an individual job from Gusto.

Delete Time Tracking Time Sheet

Tool to delete a time sheet from Gusto time tracking.

Delete Work Address

Tool to delete an employee's work address from Gusto.

Download Employee Forms PDF

Tool to get the link to an employee form PDF.

Download Company Forms PDF

Tool to get the link to a company form PDF.

Finish company onboarding

Tool to finish company onboarding in Gusto.

Get Benefit

Tool to retrieve a benefit supported by Gusto.

Get Company Departments

Tool to retrieve all departments of a company from Gusto.

Get company

Tool to retrieve company details from Gusto by company UUID.

Get Company Attachment Download URL

Tool to retrieve a temporary URL to download a company attachment file.

Get Company Benefit

Tool to retrieve a specific company benefit by its UUID.

Get Company Earning Types

Tool to retrieve all earning types (default and custom) for a company.

Get company holiday pay policy

Tool to retrieve a company's holiday pay policy including which federal holidays are selected and which employees are covered.

Get Company Locations

Tool to get all company locations.

Get company onboarding status

Tool to retrieve a company's onboarding status from Gusto.

Get company report template

Tool to get a report template for a company.

Get Company Suspensions

Tool to retrieve all suspension records for a company.

Get compensation

Tool to retrieve compensation details by compensation UUID.

Get Contractor

Tool to retrieve a specific contractor by UUID from Gusto.

Get Contractor Address

Tool to retrieve a contractor's address from Gusto.

Get Contractor Bank Accounts

Tool to get all bank accounts for a specific contractor.

Get Contractor Document

Tool to retrieve a contractor document by UUID.

Get Contractor Document PDF

Tool to retrieve the PDF download URL for a contractor document.

Get Contractor Payment Groups

Tool to get contractor payment groups for a company.

Get Contractor Payments

Tool to retrieve contractor payments for a company within a specified date range.

Get Department

Tool to retrieve details of a specific department from Gusto by department UUID.

Get employee

Tool to retrieve detailed information about an employee by their UUID.

Get Employee All Benefits

Tool to get all benefits for a specific employee by their UUID.

Get Employee Bank Accounts

Tool to retrieve all bank accounts for a specific employee.

Get Employee Benefit

Tool to retrieve a specific employee benefit enrollment by UUID.

Get employee federal taxes

Tool to retrieve an employee's federal tax withholding information including W4 details.

Get Employee Form

Tool to get a specific employee form by employee ID and form ID.

Get employee jobs

Tool to retrieve all jobs for a specific employee in Gusto.

Get Employee Payment Method

Tool to retrieve an employee's payment method configuration.

Get employee pay stub

Tool to retrieve an employee's pay stub for a specified payroll as a PDF file.

Get Employee Recurring Reimbursements

Tool to get all recurring reimbursements for an employee.

Get employee state taxes

Tool to retrieve an employee's state tax information including withholding details and state-specific questions.

Get federal tax details

Tool to retrieve federal tax details for a company including EIN verification status, tax payer type, filing form, and deposit schedule.

Get Company Form

Tool to get a company form by its UUID.

Get Garnishment

Tool to retrieve a garnishment (employee deduction) from Gusto by garnishment UUID.

Get Home Address

Tool to get an employee's home address by its UUID.

Get job

Tool to retrieve a specific job by UUID in Gusto.

Get location

Tool to retrieve a specific location by UUID.

Get Notification

Tool to retrieve a notification's details by UUID from Gusto.

Get payroll

Tool to retrieve a single payroll by its UUID.

Get payroll receipt

Tool to retrieve a payroll receipt by payroll UUID.

Get pay schedule

Tool to retrieve a specific pay schedule by its UUID.

Get People Batches

Tool to retrieve the status and results of a people batch from Gusto.

Get Recurring Reimbursement

Tool to get a recurring reimbursement by its UUID.

Get report

Tool to get a company's report given the request_uuid.

Get salary estimate

Tool to retrieve a salary estimate for an S-Corp owner from Gusto.

Get state tax requirements

Tool to retrieve state-specific tax requirements for a company in Gusto.

Get Company Benefit Summary

Tool to retrieve summary benefit data for a specific company benefit.

Get Tax Liabilities

Tool to retrieve tax liabilities for a company's external payrolls.

Get Time Off Policy

Tool to retrieve a specific time off policy by UUID from Gusto.

Get time tracking time sheet

Tool to fetch a time sheet by UUID.

Get token info

Tool to retrieve scope and resource information associated with the current access token.

Get Work Address

Tool to retrieve an employee work address by UUID.

Invite Signatory

Tool to invite a signatory with minimal information.

List ACH Transactions

Tool to retrieve all ACH transactions for a company.

List Company Attachments

Tool to retrieve a list of all attachments uploaded by a company.

List Benefits

Tool to retrieve all benefits supported by Gusto.

List Benefits Requirements

Tool to retrieve field requirements for a specific benefit type.

List Company Custom Fields

Tool to retrieve the custom fields configured for a company.

List Companies Time Off Requests

Tool to retrieve all time off requests for a company in Gusto.

List Company Bank Accounts

Tool to retrieve all bank accounts for a specific company.

List Company Benefits

Tool to retrieve all benefits offered by a company.

List Company Benefits Contribution Exclusions

Tool to retrieve all contributions for a given company benefit and whether they are excluded or not.

List Company Benefits Employee Benefits

Tool to retrieve all employee benefits for a specific company benefit.

List Company Forms

Tool to get a list of all company's forms.

List Contractor Documents

Tool to get all documents for a specific contractor in Gusto.

List Contractor Forms

Tool to get a list of all contractor's forms.

List contractor onboarding status

Tool to retrieve a contractor's onboarding status from Gusto.

List Contractor Payment Details

Tool to get payment details for contractors in a company, including their payment methods and bank account details for direct deposit.

List Contractor Payment Method

Tool to fetch a contractor's payment method configuration.

List Contractors

Tool to get all contractors for a company including individuals and businesses.

List Employee Custom Fields

Tool to retrieve the custom fields configured for an employee.

List Employee Forms

Tool to get a list of all employee's forms.

List Employee Home Addresses

Tool to get an employee's home addresses.

List employee onboarding status

Tool to retrieve an employee's onboarding status from Gusto.

List Employees

Tool to get all employees for a given company including onboarding, active, and terminated employees.

List Employee Work Addresses

Tool to get all work addresses for a specific employee.

List Employment History

Tool to retrieve employment history for a given employee, including terminations and rehires.

List Child Support Agencies

Tool to retrieve child support agency data including FIPS codes, payment requirements, and required attributes for each state.

List Information Requests

Tool to fetch all information requests for a company in Gusto.

List job compensations

Tool to retrieve all compensations for a specific job in Gusto.

List migration readiness

Tool to check if a Gusto company is ready to be migrated to embedded payroll.

List Minimum Wages

Tool to get minimum wages for a specific location.

List Notifications

Tool to retrieve all notifications relevant for a company.

List Paid Holidays

Tool to retrieve a company's paid holidays from Gusto.

List Employee Payment Details

Tool to fetch payment details for employees in a company including payment methods and bank account details.

List Pay Periods

Tool to retrieve pay periods for a company.

List Payroll Blockers

Tool to retrieve all payroll blockers for a company.

List Payroll Reversals

Tool to retrieve all approved payroll reversals for a company.

List pay schedules

Tool to retrieve all pay schedules for a company.

List pay schedules assignments

Tool to retrieve the current pay schedule assignment for a company, including pay schedules and employee/department mappings.

List pay schedules preview

Tool to preview pay schedule dates with specified parameters for the next 18 months.

List Pay Stubs

Tool to get an employee's pay stubs including payment details and amounts.

List Recovery Cases

Tool to fetch all recovery cases for a company.

List Signatories

Tool to retrieve all company signatories.

List Tax Requirements

Tool to retrieve all tax requirement states for a company.

List Time Off Activities

Tool to get employee time off activities for a specific time off type.

List Time Off Policies

Tool to retrieve all time off policies for a company.

List Time Tracking Time Sheets

Tool to fetch all company's time sheets representing time worked by employees or contractors.

List unprocessed termination pay periods

Tool to retrieve unprocessed termination pay periods for a company.

List Wire In Requests

Tool to retrieve all Wire In Requests for a company.

List YTD Benefit Amounts From Different Company

Tool to retrieve year-to-date benefit amounts contributed at a different company for an employee.

Remove Employees from Holiday Pay Policy

Tool to remove employees from a company's holiday pay policy in Gusto.

Remove People From Department

Tool to remove employees and contractors from a department in Gusto.

Remove Employees from Time Off Policy

Tool to remove employees from a time off policy in Gusto.

Retrieve Terms of Service Status

Tool to retrieve the user acceptance status of Gusto Embedded Payroll's Terms of Service.

Update Company

Tool to update a company in Gusto.

Update Company Benefit Contribution Exclusions

Tool to update contribution exclusions for a company benefit in Gusto.

Update Company Benefit

Tool to update an existing company benefit in Gusto.

Update Contractor Address

Tool to create or update a contractor's address in Gusto.

Update Contractor Payment Method

Tool to update a contractor's payment method in Gusto.

Update Department

Tool to update a department in Gusto.

Update Earning Type

Tool to update an earning type in Gusto.

Update Employee

Tool to update an employee in Gusto.

Update Employee Bank Account

Tool to update an employee bank account in Gusto.

Update Employee Benefit

Tool to update an individual employee benefit by its UUID in Gusto.

Update Employee Benefits

Tool to bulk update or create employee benefits for a company benefit in Gusto.

Update Employee Onboarding Status

Tool to update the onboarding status of an employee in Gusto.

Update Employee Payment Method

Tool to update an employee's payment method in Gusto.

Update Employee Rehire

Tool to update an employee rehire in Gusto.

Update Employee Termination

Tool to update an existing employee termination in Gusto.

Update Federal Tax Details

Tool to update federal tax details for a company in Gusto.

Update Employee Federal Taxes

Tool to update federal tax information for an employee in Gusto.

Update Garnishment

Tool to update an existing garnishment in Gusto.

Update Historical Employee

Tool to update a historical employee in Gusto.

Update Holiday Pay Policy

Tool to update a company's holiday pay policy in Gusto.

Update Home Address

Tool to update an employee's home address in Gusto.

Update Company Industry Selection

Tool to update the industry classification for a company by providing a NAICS code.

Update Jobs

Tool to update a job in Gusto.

Update location

Tool to update an existing location in Gusto.

Update Onboarding Documents Config

Tool to update an employee's onboarding documents configuration in Gusto.

Update pay schedule

Tool to update a pay schedule in Gusto.

Update recurring reimbursement

Tool to update an existing recurring reimbursement in Gusto.

Update Salary Estimate

Tool to update a salary estimate for an S-Corp owner in Gusto.

Update Section 603 High Earner Status

Tool to update an employee's Section 603 high earner status for a specific year.

Update State Taxes

Tool to update state tax attributes for an employee in Gusto.

Update State Tax Requirements

Tool to update state tax requirements for a company in Gusto.

Update time off policy balance

Tool to update time off hours balances for employees under a time off policy.

Update Time Off Policy

Tool to update a time off policy in Gusto.

Update Time Tracking Time Sheet

Tool to update a time tracking time sheet in Gusto.

Update Work Address

Tool to update an employee work address in Gusto.

SETUP GUIDE

Connect Gusto MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

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

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Gusto
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Summarize upcoming payroll deadlines in Gusto for this month'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Gusto API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

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

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Gusto Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List active employees in Gusto and summarize their employment status'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Gusto actions with your Agent

Why Use Composio?

AI Native Gusto Integration

  • Supports both Gusto MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable payroll, benefits, and HR tool execution
  • Rich coverage for reading, writing, and querying your Gusto employee and company data

Managed Auth

  • Built-in OAuth handling with token storage, refresh, and lifecycle management
  • Central place to manage, scope, and revoke Gusto access
  • Per user and per environment credentials instead of hard-coded secrets in your agent code

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Clear tool schemas help agents understand Gusto actions like listing employees, checking payroll details, and reviewing benefits
  • 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 Gusto
  • Scoped, least privilege access to sensitive payroll and HR resources
  • Full audit trail of agent actions to support review, compliance, and internal approvals
FRAMEWORKS

Use Gusto with any AI Agent Framework

Choose a Framework you want to connect Gusto with

FAQ

Frequently asked questions

Yes, Gusto requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.

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

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

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

Start with Gusto.It takes 30 seconds.

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

Start building