Gusto MCP server

Connect Gusto to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Gusto MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the manage employee benefit tool in Gusto
  • Use the manage job & compensation tool in Gusto
  • Use the manage contractor payment tool in Gusto
  • Use the manage earning type tool in Gusto
  • Use the list contractors tool in Gusto
  • Use the list employees tool in Gusto

Supported Tools

manage_employee_benefit

Manage Employee Benefit

List, create, or update employee benefit enrollments. Enrolls employees in company-defined benefit plans with specified contribution amounts and deduction settings.

manage_job_compensation

Manage Job & Compensation

Manage employee jobs and compensations. Job list/create/update endpoints require an approved Embedded Payroll application. List jobs for an employee, create/update jobs, and manage compensation details (rate, payment unit, FLSA status). Jobs represent positions held by an employee, and each job can have multiple compensations with effective dating.

manage_contractor_payment

Manage Contractor Payment

List contractor payments grouped by contractor and returned as individual payments. Creating or cancelling payments requires an approved Embedded Payroll application with payrolls:run. Use get_current_context to discover the authorized company.

manage_earning_type

Manage Earning Type

List, create, or update custom earning types for a company. Earning types define categories of compensation (e.g., bonuses, commissions, tips) beyond standard types.

list_contractors

List Contractors

List contractors (1099 workers) for a company. Returns contractor profiles including names, types, and status.

list_employees

List Employees

List employees for a company. Supports filtering by termination status and pagination. Returns employee profiles including names, emails, and employment details.

process_payroll

Process Payroll

Request asynchronous payroll calculation or submission for an approved Embedded Payroll company. Gusto app integrations cannot run payroll. A successful response confirms acceptance; use get_payroll to verify the eventual processing outcome.

manage_employee

Manage Employee

Create, update, retrieve, terminate, or rehire a W-2 employee. - To **create**: provide companyId, firstName, lastName, and optionally other fields. - To **get** or **update**: provide employeeId and any fields to update. - To **terminate**: provide employeeId and termination details. - To **rehire**: provide employeeId and rehire details.

manage_time_off

Manage Time Off

List time off policies for a company or retrieve an employee's time off activity for one exact type. Use company policies to identify the exact timeOffType required for get_balances.

manage_garnishment

Manage Garnishment

List, create, or update wage garnishments for an employee. Supports ordinary garnishments with exact amounts and schedules; specialized child-support setup must be completed in Gusto.

manage_department

Manage Department

List, create, or update departments for a company. Departments help organize employees and can be used for reporting and payroll categorization.

manage_company_benefit

Manage Company Benefit

List, create, retrieve, or update company-level benefit types (health insurance, 401(k), HSA, etc.). Company benefits define the benefit plans available to employees.

list_pay_schedules

List Pay Schedules

List pay schedules for a company. Pay schedules define the frequency and timing of payroll runs (weekly, biweekly, semi-monthly, monthly).

manage_company_location

Manage Company Location

List, create, or update company locations. Locations are used for tax jurisdiction purposes and employee work addresses.

get_company

Get Company

Retrieve detailed information about a Gusto company, including its profile, locations, and configuration. Use this to look up company details by company ID.

get_payroll

Get Payroll

Retrieve detailed information about a specific payroll, including employee compensations, taxes, deductions, and totals.

manage_contractor

Manage Contractor

Create, retrieve, or update a contractor (1099 worker). - To **create**: provide companyId, type, and contractor details. - To **get**: provide contractorId. - To **update**: provide contractorId and fields to change.

list_forms

List Forms

List company or employee form metadata, or retrieve one form by ID. These endpoints require an approved Embedded Payroll application and company_forms:read or employee_forms:read. No form content or signing operation is returned.

list_payrolls

List Payrolls

List payrolls for a company. Can filter by processing status and date range. Returns payroll summaries including pay period, status, and totals.

get_current_context

Get Current Context

Discover the current Gusto token resource, resource owner, granted scopes and company UUID. Each OAuth grant targets one company; use this companyId in other tools. Name and email are omitted when the provider does not expose them.

Connect Gusto to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Gusto in Metorial. In your Metorial portal, enable the Gusto MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Gusto tools.

Run Gusto through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Gusto and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Gusto tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Gusto

Linkedin

Authenticate LinkedIn members with OpenID Connect, fetch the authenticated member profile, and create self-serve LinkedIn shares with text, article links, and uploaded images. Organization and Community Management workflows should move to a separate slate because LinkedIn restricts combining those products in one app.

Zoho

Manage Zoho CRM, Bigin, Books, Inventory, Invoice, Desk, Mail, People, and Projects from one connection. Discover organizations and accounts, manage records and financial documents, work with support tickets and email, and organize employee and project data.

Quickbooks

Manage business finances and accounting in QuickBooks Online. Create, send, and track invoices. Manage bills and accounts payable, record bill payments. Create and update customer and vendor records with contact details and hierarchies. Record payments against invoices and credit memos. Create estimates, sales receipts, and journal entries. Track expenses and categorize against the chart of accounts. Manage items, products, services, and inventory levels. Query entities using SQL-like syntax and sync incremental changes via Change Data Capture. Generate financial reports including profit and loss, balance sheet, and cash flow. Process credit card and bank account (ACH) payments via the Payments API. Manage the chart of accounts for tracking income, expenses, assets, and liabilities.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Gumroad

Manage digital and physical product sales on Gumroad. View and update product metadata, create and manage variant categories and options, and configure discount offer codes. Retrieve and filter sales data by date range for reporting. Manage subscribers and subscription lifecycles for recurring products. Refund sales, revoke or restore buyer access, and track payouts. Verify, enable, disable, and decrement license keys for purchase validation. Draft, schedule, and send audience emails to customers and followers. Read product reviews and access authenticated user profile information.

Stripe

Process payments, manage subscriptions, and handle invoices. Create and manage customers, payment methods, and product catalogs. Issue refunds, handle disputes, and submit chargeback evidence. Create checkout sessions and payment links. Manage connected accounts and platform fund flows via Stripe Connect. Configure payouts to bank accounts and debit cards. Apply coupons and promotion codes to subscriptions and invoices. Calculate and collect taxes automatically. Access balance information and transaction history. Upload files for dispute evidence and identity verification. Create and manage virtual and physical payment cards via Issuing. Receive real-time webhook notifications for payment, subscription, invoice, and account events.

Technical notes for Gusto

Discover the authorized Gusto company, read personnel and payroll records, and manage documented benefits, locations, departments and compensation. Payroll processing, contractor payment writes, job management and form metadata require approved Embedded Payroll capabilities.

Frequently asked questions

Common questions about connecting Gusto to AI agents with Metorial.

  1. How many tools does the Gusto MCP server have?
    The Gusto MCP server exposes 20 tools, including Manage Employee Benefit, Manage Job & Compensation, Manage Contractor Payment. Each one is governed and traced through Metorial.
  2. Gusto exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Gusto MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Gusto and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Gusto MCP server yourself or use the hosted gateway.

Connect Gusto to production AI agents

See how Metorial gives your team governed access to Gusto, with tracing and security controls built in.