How to integrate Gusto MCP with Codex

Connect Codex to Gusto MCP. List active employees by department, summarize upcoming payroll deadlines this month, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
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

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With Gusto MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer.

Also integrate Gusto with

Claude Cowork

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Gusto MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

What is the Gusto MCP server, and what's possible with it?

The Gusto MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Gusto account. It provides structured and secure access so your agent can perform Gusto operations on your behalf.

Conclusion

You've successfully integrated Gusto with Codex using Composio's MCP server. Now you can interact with Gusto directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Gusto operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1000+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Gusto operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
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.

FRAMEWORKS

How to build Gusto MCP Agent with another framework

Claude Cowork logo

Claude Cowork

Use Gusto MCP with Claude Cowork

FAQ

Frequently asked questions

With a standalone Gusto MCP server, the agents and LLMs can only access a fixed set of Gusto tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Gusto and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Codex fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Gusto tools.

Yes, absolutely. You can configure which Gusto scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Gusto data and credentials are handled as safely as possible.

Start with Gusto.It takes 30 seconds.

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

Start building
Customer stories

Teams ship real agents on Composio

GET STARTED FOR FREEBOOK A DEMO
agent.aiZoomLettaGleanHubSpotAWSWabi

Karan skipped his own birthday party to fix our critical issue. It was 10pm and he diverted his Waymo to help us instead. This really sets the bar — it shows the commitment you need when users rely on your software.

Harsha Gaddipati
Harsha Gaddipati
Co-founder, Slashy

A lot of students tell us that the moment their connected tools start talking to each other inside Opennote feels almost magical. The agent just knows them, and it's immensely helped keep new users on the platform.

Abhi Arya
Abhi Arya
Co-founder, Opennote

We chose Composio over Pipedream because it delivered depth where it mattered — niche tools and tricky edge cases other platforms simply ignored. That gave us confidence to scale without compromising.

Nirman Dave
Nirman Dave
CEO, Zams

As a solo builder, shipping fast is life or death. The only way I can outcompete incumbents is by outmanoeuvring them. Getting bogged down managing agent auth would have been a death sentence.

Ryan Yu
Ryan Yu
Founder, Extra Thursday

Before Composio, adding tool integrations was slow and resource-intensive. Each one could take weeks of engineering time, and maintaining them meant constantly keeping up with API changes.

Tomisin Jenrola
Tomisin Jenrola
Founder & CEO, SwarmZero

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Jerome Leclanche
Jerome Leclanche
Co-Founder, Ingram Technologies