Gusto MCP Server

Gusto's hosted MCP server for asking about and acting on a company's payroll, staff and time off

Official · gusto.com Remote (hosted) · Streamable HTTP Finance and payments

40 popularity score

Connect your client

Remote (hosted)

Add in one click

Opens the app, which asks before it adds the server.

Or add it by command or config

Claude (desktop and web)Settings > Connectors > Add custom connector, URL https://mcp.api.gusto.com
https://mcp.api.gusto.com/
ChatGPTPlugins, search for Gusto and add it
https://mcp.api.gusto.com/
Cursormcp.json (Cursor Settings > Tools & Integrations > New MCP Server)
{
  "mcpServers": {
    "gusto-mcp": {
      "url": "https://mcp.api.gusto.com/"
    }
  }
}
Gemini CLIsettings.json in the .gemini folder
{
  "mcpServers": {
    "gusto": {
      "httpUrl": "https://mcp.api.gusto.com"
    }
  }
}

What it does

The Gusto MCP Server is a hosted endpoint run by Gusto at https://mcp.api.gusto.com. An admin connects it to an assistant with OAuth, picks which data categories to share, and the assistant can then read and change that Gusto company: employees and contractors, payrolls and pay schedules, departments and locations, time records and time-off requests, and payroll reports returned as CSV.

It goes beyond reading records. Tools can edit and submit an unprocessed payroll, add or change one employee or contractor at a time, enter hours, and walk a new business through Gusto signup: creating the company, linking a funding bank account through Plaid, preparing an EIN (Form SS-4) or S-Corp election (Form 2553), and paying for an EIN filing through a Stripe checkout link. A few tools give estimates (S-Corp savings, a reasonable owner salary, the R&D tax credit) that the docs say are not tax advice.

Gusto's tool reference lists 72 tools. List tools page at 25 results by default and up to 100 with `per`, and take an `include` parameter to return only chosen fields. For testing before connecting real company data, the docs name a separate demo endpoint, https://mcp.api.gusto-demo.com, used with a demo company from dev.gusto.com. Gusto points developers building on its API to a different server, the Embedded Dev Assistant MCP.

What it needs

A Gusto account with global/full admin rights on the company being connected. An MCP client that can add a remote server and sign in with OAuth (PKCE); the docs say Claude needs a Pro or Max plan and Cursor a Pro+ plan for this. In Gemini CLI, run /mcp auth gusto after adding the server to finish sign-in.

Limits

Each connection reaches only the data categories chosen at sign-in; changing them means disconnecting and reconnecting. Rate limits apply and are not published: an over-limit call gets a 429 with Retry-After. search_workers_comp_class covers Washington and Wyoming only. file_scorp_election prepares Form 2553 but the owner must still mail it to the IRS. The tax estimate tools are labelled as estimates, not tax advice. Tools that need an SSN or bank numbers open a Gusto or Plaid page instead of taking them in chat. Gusto's docs warn that the assistant can misread data and that answers should be checked in Gusto.

Who it suits

Suits owners and admins of a Gusto company who want to ask about headcount, payroll costs, contractors or time off, prepare and submit payroll, or set up a new company from an assistant, without running anything locally. Because it can submit payroll and change staff records, it fits people who will confirm each tool call. Developers building an app on the Gusto API are pointed by Gusto to its Embedded Dev Assistant MCP instead. Those not on Gusto, or without admin rights, cannot use it.

Tools 60 of 72

create_company
Sets up a new Gusto company and its payroll admin account, with a confirm step first
get_company
Returns the company's legal name, entity type, EIN, contacts and locations
get_company_onboarding_status
Shows which company setup questions are still open and what comes next
get_company_onboarding_package
Shows the plans, add-ons and benefits offered during setup and the suggested one
save_company_onboarding_answer
Stores the answer to one setup question
create_secure_gusto_session
Opens a Gusto page where the user signs forms or becomes signatory outside the chat
manage_account
Checks whether a password is set, or sends the password setup email again
manage_company_members
Adds or edits one employee or contractor and can send them an onboarding invite
check_plaid_connection_status
Checks whether the payroll funding bank account linked via Plaid is verified
connect_bank_via_plaid
Starts a Plaid page for linking the payroll funding bank account
check_ein_status
Checks whether a federal EIN application has been issued
file_ein
Prepares and checks a Form SS-4 EIN application
pay_ein_filing
Makes a Stripe checkout link to pay for a prepared EIN application
check_scorp_election_status
Checks whether a Form 2553 S-Corp election is finalized
file_scorp_election
Prepares a Form 2553 S-Corp election, which the owner must still mail
calculate_scorp_tax_savings
Estimates what a single-member LLC might save by electing S-Corp status
calculate_reasonable_salary
Works out a reasonable W-2 salary for an S-Corp owner from BLS wage data
calculate_rd_tax_credit
Estimates a possible federal R&D tax credit from headcount, pay and industry
search_business_info
Turns a plain description into NAICS industry or BLS occupation codes
search_workers_comp_class
Finds workers' comp class codes for a job, in Washington and Wyoming only
look_up_employment_compliance
Searches Gusto's notes on US employment rules by place
create_reports
Queues payroll journal, cash requirement or contractor payment reports
get_reports
Checks queued reports and returns their CSV when done
get_payroll
Returns one payroll with earnings, taxes, deductions and net pay per worker
list_payrolls
Lists payroll runs, filtered by pay period dates unless told otherwise
list_payroll_blockers
Lists what stops a payroll from being processed
update_payroll
Changes hours, earnings, time off, memos or payment method on an unprocessed payroll, up to 100 people per call
run_payroll
Calculates and submits an unprocessed payroll
get_employee
Returns one employee's record
list_employees
Lists employees with filters
get_employee_earnings_summary
Breaks down commissions, bonuses and tips per employee over a date range
list_employee_home_addresses
Lists an employee's home addresses
get_employee_rehire
Returns rehire details for a returning employee
list_employee_work_addresses
Lists an employee's work locations
list_employee_custom_fields
Lists custom field values for an employee
list_employee_employment_history
Lists an employee's roles and status changes over time
list_employee_terminations
Lists an employee's separation records
list_employee_jobs
Lists an employee's jobs
list_job_compensations
Lists the pay rate history of a job
list_departments
Lists the company's departments
list_locations
Lists the company's locations
list_custom_fields_schema
Lists the custom fields the company has defined
list_earning_types
Lists the company's earning types
list_contractors
Lists contractors, with search and paging
get_contractor
Returns one contractor's record
list_contractor_payments
Lists contractor payments in a date range
get_contractor_payment_group
Returns the payments in one batch contractor payment
list_contractor_payment_groups
Lists batch contractor payments
get_time_off_balances
Returns available, accrued, used and pending time off per policy
get_time_off_request
Returns one time-off request
list_time_off_requests
Lists time-off requests by status, dates or employee
get_time_sheet
Returns entries of one timesheet from a third-party time tool
list_time_records
Lists time records for a pay period from Gusto or a linked time tool
record_time
Enters hours for one worker for a pay period
get_pay_schedule
Returns one pay schedule
list_pay_schedules
Lists the company's pay schedules
list_pay_periods
Lists pay periods and their payroll runs
list_pay_schedule_assignments
Shows which employees follow which pay schedule
get_token_info
Shows the scopes and companies the current connection can reach
submit_feedback
Sends feedback about the MCP server to Gusto

Similar servers