productivityoauth2

Gusto

Payroll, benefits, HR.

Verdict

The Gusto MCP connects your team's AI to payroll, benefits, and HR data. An @mention lets you query employee records, pull time-off balances, check payroll runs, and surface compliance deadlines without opening the Gusto dashboard. Finance and People Ops teams use it to answer headcount questions during planning calls, verify PTO before approving requests, and audit contractor payments. Setup requires OAuth with read scopes for employees and payroll; write access is not exposed for safety. If your org uses a different HRIS, this won't help.

Common use cases

  • Check PTO balances before approving leave requests
  • Pull headcount by department for budget planning
  • Verify contractor payment status during invoicing
  • Surface upcoming payroll deadlines in standups
  • Audit benefits enrollment before open enrollment

Integration

Vendor
Gusto
Category
productivity
Auth
OAUTH2
Composio slug
gusto

Tools

Per-tool listings haven't synced yet for Gusto. The connection itself works - your Space can already @-mention it. Tool descriptions will fill in on the next Composio ingest.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Find Gusto in the MCP directory and click Connect. 3. You'll be redirected to Gusto's OAuth consent screen—sign in with an admin account that has access to payroll and employee data. 4. Grant read permissions for employees, payroll runs, time off, and benefits (Switchy does not request write scopes). 5. After authorizing, you'll return to Switchy and see a green checkmark next to Gusto. 6. Open any Space, type '@Gusto list employees' and send—if the MCP replies with a roster or employee count, the connection is live. 7. If authentication fails, verify your Gusto account has API access enabled (some legacy plans require an upgrade).

What teammates see: by default, memories from Gusto are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

List Active Employees

@Gusto list all active employees with their department, title, and hire date
Open in a Space →

Check PTO Balances

@Gusto show the current PTO balance for [employee name], including vacation and sick leave accrued
Open in a Space →

Summarize Last Payroll

@Gusto summarize the last payroll run, including total gross pay, deductions, and the date it was processed
Open in a Space →

Upcoming Compliance Deadlines

@Gusto list any upcoming payroll tax deadlines or benefits compliance tasks in the next 30 days
Open in a Space →

Contractor Payment Status

@Gusto check if [contractor name] has been paid this month and show the payment amount and date
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Gusto show me all employees hired in the last 90 days with their department and start date

Output

Based on your Gusto account, 7 employees joined in the last 90 days: • Sarah Chen (Engineering) – started March 15, 2024 • Marcus Williams (Sales) – started March 22, 2024 • Priya Patel (Product) – started April 1, 2024 • James Rodriguez (Engineering) – started April 8, 2024 • Emma Thompson (Marketing) – started April 15, 2024 • David Kim (Operations) – started May 3, 2024 • Lisa Martinez (Customer Success) – started May 10, 2024 This list reflects active employees only; terminated records are excluded by default.

Notes

This example demonstrates read access to employee roster data. Requires OAuth scope for employee directory access. The MCP returns current snapshot data — historical changes (like department transfers after hire date) won't appear in this view unless you query payroll history separately.

Prompt

@Gusto create a time-off request for employee ID 847392 from June 10-14 as paid vacation

Output

Time-off request created successfully: • Employee: Jordan Lee (ID: 847392) • Type: Paid Vacation • Dates: June 10–14, 2024 (5 business days) • Status: Pending manager approval • Balance after approval: 8.5 days remaining The request has been routed to Jordan's manager (Alex Rivera) for approval. You'll receive a notification once the decision is recorded in Gusto.

Notes

This write operation requires elevated OAuth permissions for time-off management. The MCP submits the request but cannot bypass your company's approval workflow — managers still need to act in Gusto's UI or via their own integrations. Side-effect: this action is immediately visible to the employee and their manager.

Prompt

@Gusto pull total payroll cost by department for Q1 2024 and draft a summary comparing it to our $2.1M budget

Output

Q1 2024 payroll totals by department: • Engineering: $847,200 (40.3% of total) • Sales: $512,600 (24.4%) • Product: $298,100 (14.2%) • Operations: $223,400 (10.6%) • Marketing: $156,700 (7.5%) • Customer Success: $62,000 (3.0%) **Total: $2,100,000** — exactly on budget. Engineering's share grew 3.2 percentage points vs. Q4 2023, driven by four mid-level hires in February. Sales compensation held steady despite two departures, suggesting higher per-rep costs or commission acceleration. All other departments tracked within 1% of prior quarter.

Notes

This synthesis example pairs Gusto's payroll data with AI reasoning to produce budget analysis. Requires read access to payroll reports, which may be restricted to admin roles in your Gusto account. The MCP provides raw figures; the AI generates the comparative narrative and percentage calculations.

Use-case deep-dives

Onboarding automation for remote teams

When Gusto MCP fits payroll-driven onboarding flows

A 12-person remote startup hires two engineers in one week. HR needs to provision payroll, benefits, and tax forms without toggling between Gusto's web UI and Slack threads. The Gusto MCP lets an AI agent pull employee records, verify I-9 status, and confirm direct deposit setup in a single conversation. This works if your onboarding checklist lives in a tool like Notion or Linear and you want the AI to cross-check Gusto state without manual lookups. The threshold: if you're hiring fewer than one person per month, the OAuth setup overhead outweighs the time saved. For teams onboarding weekly, the MCP turns a 15-minute admin task into a 2-minute query.

Monthly payroll reconciliation for finance

Gusto MCP for end-of-month payroll audits

A finance lead at a 30-person SaaS company closes the books on the last Friday of each month. She needs to confirm that Gusto's payroll run matches the accrual in QuickBooks and that no contractor payments are missing. The Gusto MCP can surface payroll totals, tax withholdings, and contractor 1099 data in a shared AI workspace where the rest of the finance team reviews discrepancies. This scenario assumes Gusto is the single source of truth for comp data. If you're also running ADP or Rippling in parallel, the MCP won't reconcile across vendors. For single-vendor shops doing monthly close, the MCP cuts reconciliation time by half.

Benefits enrollment support during open season

When Gusto MCP helps HR answer benefits questions at scale

A 50-person agency runs annual benefits enrollment in November. Employees ping HR in Slack with questions about HSA limits, 401(k) match schedules, and PTO accrual. The Gusto MCP lets HR reps query plan details and individual enrollment status without leaving the conversation. This works if your benefits are fully managed in Gusto and you're fielding more than 20 questions per week during enrollment. The MCP won't help if your benefits are split across Gusto and a separate carrier portal. For teams where Gusto owns the full benefits stack, the MCP turns a 5-minute lookup into a 30-second inline answer.

Frequently asked

What does the Gusto MCP do in Switchy?

The Gusto MCP connects your Gusto payroll and HR account to Switchy's AI workspace, letting your team query employee data, run reports, and automate payroll tasks through natural language. Your AI can pull headcount numbers, check PTO balances, or surface benefits info without logging into Gusto's dashboard. Useful for finance and ops teams who need payroll context in their daily workflows.

Do I need admin access to connect Gusto via OAuth?

Yes. Gusto's OAuth flow requires account admin permissions to authorize the connection. If you're not an admin, you'll hit a permissions error during setup. The person who connects it controls which data scopes Switchy can access — typically payroll, employee records, and time tracking. Non-admins can use the MCP once it's connected, but they can't install it.

Can the Gusto MCP process payroll runs or change employee salaries?

No. The Gusto MCP is read-only by design. It can surface payroll data, employee details, and benefits info, but it won't submit payroll, adjust salaries, or modify tax settings. If you need to make changes, you'll still open Gusto directly. This keeps your payroll operations safe while giving your team fast access to the data they reference constantly.

How is this different from using Gusto's API directly?

Gusto's API requires you to write code, manage tokens, and parse JSON responses. The MCP wraps that complexity so your team asks questions in plain English instead. You get the same underlying data, but without building a custom integration. If you already have engineering resources and want full control, use the API. If you want payroll context in your AI workspace today, use the MCP.

Who on the team should connect the Gusto MCP?

Your finance lead or HR admin — whoever owns your Gusto account and understands which employee data your team needs access to. They'll authorize the OAuth connection and confirm the scopes. Once connected, anyone in your Switchy workspace can query the data through AI, but the admin controls what's exposed. One connection covers your whole team.

Data last verified 7 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.