Connect your account, then chat with AI to run tools.
Read Gusto company, payroll, tax, benefits, time off, and workforce data plus token context for HR and payroll automation from chat.
Try this workflow
Confirm what this Gusto connection can do
Call Gusto token info and summarize the granted scopes, resource type, and resource id in one short paragraph.
Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.
Browse all toolsBuilt for
Integration engineers, payroll product teams, HRIS automation builders, and partners wiring broad Gusto reads into internal systems
Confirm what this Gusto connection can do
Grounds every later call in the actual OAuth grant before touching company data.
Call Gusto token info and summarize the granted scopes, resource type, and resource id in one short paragraph.
Summarize the live payroll calendar
Exercises company-scoped reads that mirror how operators reason about payroll cadence.
Using the company UUID from token info, list pay schedules and summarize each frequency, anchor pay date, and whether autopayroll is enabled.
Spot payroll submission blockers
Uses payroll health reads that explain why a run cannot submit.
Using the company UUID from token info, fetch payroll blockers and summarize each blocker message and which payroll or employee it references.
Compare time off policies
Covers policy list plus single-policy reads for HR operators.
List the company's time off policies, fetch details for the first policy, and summarize accrual rules and waiting periods in plain language.
What does this Gusto bundle expose over MCP?
Read-only payroll and HR context: token metadata, tax and banking posture, work sites, attachments, forms, admins, employees with addresses jobs and pay stubs, contractors with payout accounts, calendars and assignments, payroll runs with reversals blockers and summaries, benefits catalog offerings and enrollments, holiday and time-off posture, imported payroll batches, and garnishment lookup data.
Why would some reads return empty lists?
The company may genuinely have no rows for that resource yet (for example no external payrolls or open time-off requests), or the OAuth grant may omit the upstream scope family so Gusto withholds detailed payloads while still returning successfully.
Why would a company or payroll read return 403?
The granted scope string may omit the upstream scope required for that family of endpoints, or the token may be bound to a different resource type than Company.
Domain knowledge for Gusto — workflow patterns, data models, and gotchas for your AI agent.
OAuth installs grant a bundled permission set and bind the authorization to exactly one payroll account surface — almost always one company tenant. Resolve token metadata first so you know whether you have company context and which UUID anchors every company-scoped read (tax onboarding, payout rails, filings, attachments, calendars, payroll runs, contingent workers, benefits, approvals, supplementary runs from outside Gusto). The supported-benefit catalog plus child-support agency directory are catalog queries that succeed without handing a company id.
Bare JSON arrays normalize to items + count on the MCPBundles side so pagination-style consumers behave consistently.
If a call succeeds but returns empty payloads, upstream likely never stored rows for that company, or your grant leaves some columns redacted instead of rejecting the call outright.
Employee roster search parameters and alphabetical sort toggles disagree with each other — sending both prompts upstream validation failures instead of narrowing results quietly.
Higher-sensitivity totals such as PHI-backed enrollments or historical compensation ladders show up only when those reads are expressly allowed alongside the enrichment flags documented on each tool.
Returns one company record. Needs company read access; some attributes may be absent without additional reads. When token info shows this connection i...
Lists benefits the company offers, or one offering when company_benefit_uuid is set. Needs company-benefit read access; some benefit payloads also nee...
Lists contractors for a company with search, filters, and expansions, or returns one contractor when contractor_uuid is set. Needs contractor read acc...
Returns built-in and custom earning categories configured for payroll (bonus, stipends, and similar). Needs payroll read access.
Lists employees for a company with optional filters and expansions, or returns one employee when employee_uuid is set. Needs employee read access; com...
Imports or bookkeeping payrolls mirrored into Gusto. Lists batches for the company or drills into one batch when external_payroll_uuid is set (company...
Returns federal tax setup for one company — filing accounts, withholdings linkage, and onboarding flags vendors care about during payroll setup.
Describes paid-holiday rules, multipliers, and observance handling for the roster.
Returns NAICS-aligned industry metadata Gusto captured for filings and underwriting.
Lists mailing, filing, and work-site locations under a company, or returns one location when location_uuid is set without listing. Needs company read ...
Lists payroll runs with date and status filters, or returns one payroll with optional related blocks when payroll_uuid is set. Needs payroll read acce...
Lists payroll cadences for the company or returns one schedule when pay_schedule_uuid is set (company_uuid remains required). Needs pay-schedule read ...
Breaks tax registration status down for one two-letter jurisdiction (CA, NY, …).
Returns outstanding tax-registration tasks surfaced to payroll admins (state registrations, withholdings onboarding, filings readiness).
Lists configured time off policies under the company or returns one policy when time_off_policy_uuid is set. Needs time-off read access.
Lists time off submission rows for the company or returns one submission when time_off_request_uuid is set. Needs matching time-off reads.
Whether Gusto routes contractor pay through direct deposit, manual check, or another instrument, plus validation status where present.
Lists employed roles for someone or returns one job when job_uuid is set. Needs job read access; include all_compensations only when compensation read...
Returns supported benefit definitions Gusto publishes for all companies, or one definition when benefit_uuid is set. Needs benefits read access. Use t...
Summarizes what the live authorization can access: scope text, resource type, resource id, and owner metadata. Read-only; use it before company-scoped...
Federal and state identifiers used when onboarding child-support garnishments. Reference-only rows.
Lists administrators on the account with identifiers and basic contact fields. Needs company administrator read access.
Uploaded HR and payroll artifacts (I-9 bundles, benefit PDFs, onboarding packets) with routing metadata for compliance teams.
Operational bank rails connected to payroll (masked account tokens, statuses). Needs company banking reads.
Lists people enrolled on one company benefit offering. Supports paging when available.
Summarizes contractor payouts over a calendar window. Requires start and end ISO dates and payroll read access. Optionally filter one contractor or gr...
Batch view of payout preferences for contingent workers — direct deposit tails, statuses, validation flags.
Returns custom field definitions for the company so you have ids, types, and options before reading people records. Needs company read access.
Summaries of active filings — W-4 / state withholding status, onboarding packets, filings queue.
Calendar-bound pay buckets (start/end) that anchors schedule-aware reporting.
Cross-company blockers that stop submission — missing tax setup, invalid bank routing, outstanding reversals, and similar operator-facing messages.
Payroll reversal history for compliance and funding investigations (voids, corrections).
Maps workers to payroll cadences — useful before reconciliation or remediation.
Employee-level balance snapshot for every policy on the payroll. Often large — use paging.
Bank accounts saved for a contractor profile; routing metadata may stay masked without banking reads.
Returns effective-dated home address history for one employee — used for residency and withholding context. Needs employee read access.
Prior pay slips for reconciliation: gross buckets, withholdings summaries, downloadable artifacts where your grant exposes them.
Minimum wage schedules and effective dates that apply to a physical work site (useful for compliance audits and remote-work policy checks).
Surfaces lingering severance payouts or final-check windows that payroll still owes.
Read-only Gusto data for payroll, tax, workforce, contractors, schedules, payouts, benefits, time off, and operational attachments — plus token context. It provides 39 tools that AI agents can use through the Model Context Protocol (MCP).
Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/gusto. Authentication is handled automatically.
Gusto provides 39 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.
Gusto uses One-click sign in. Gusto requires credentials. Connect via MCPBundles and authentication is handled automatically.
Read-only payroll and HR context: token metadata, tax and banking posture, work sites, attachments, forms, admins, employees with addresses jobs and pay stubs, contractors with payout accounts, calendars and assignments, payroll runs with reversals blockers and summaries, benefits catalog offerings and enrollments, holiday and time-off posture, imported payroll batches, and garnishment lookup data.
The company may genuinely have no rows for that resource yet (for example no external payrolls or open time-off requests), or the OAuth grant may omit the upstream scope family so Gusto withholds detailed payloads while still returning successfully.
The granted scope string may omit the upstream scope required for that family of endpoints, or the token may be bound to a different resource type than Company.
Connect Gusto to any MCP client in minutes
The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.
Gusto and paste the MCP URL into Remote MCP server URL.Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).
More financial integrations you might like
AgentHC Market Intelligence provides market snapshots, cryptocurrency data, and economic calendars, ...
Alpaca Broker API is a financial trading platform that offers developers access to tools for algorit...
Alpha Vantage provides real-time and historical market data across equities, forex, crypto, ETFs, an...
Analyst financial estimates, ratings, price targets, and stock grades from top analysts
Arcadia Finance provides a full suite of financial tools for managing accounts, assets, and trading ...
The aTars MCP server provides a suite of tools for accessing and analyzing financial indicators and ...