How to Use the Gusto MCP in Claude

Q: How do I connect the Gusto MCP server to my Claude Desktop app?

Open your claudedesktopconfig.json file and add the server under the mcpServers key. Provide the command and arguments for the stdio transport, save the file, and fully restart the app. You will see a hammer icon indicating the tools are active.

Q: Does Claude Desktop let me run payroll or just view it?

The current tools like listpayrolls and getpayroll are designed for reading and auditing data. You can inspect historical runs, verify totals, and check employee allocations, but you cannot execute final payments through these specific tools.

Q: What happens if I manage multiple businesses on the platform?

The listcompanies tool returns all organizations associated with your account. Your agent can switch contexts by using getcompany to fetch details for the specific entity you want to audit.

Pull live payroll and team data directly into Claude Desktop to run audits and check benefits without leaving your chat.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gusto MCP to Claude Desktop

Create your Vinkius account to connect Gusto to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Gusto with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run instant payroll audits in Claude Desktop

The Gusto MCP Server brings payroll data directly to your desktop chat window via `list_payrolls` and `get_payroll`. Your agent pulls exact dollar amounts, tax breakdowns, and processing dates without making you download CSVs or open a separate browser tab. You can ask Claude Desktop to compare the latest run against previous cycles to spot anomalies. Because it executes as a local subprocess, the data transfers directly to your local instance for fast, secure processing.

Map organizational structure in your chat

This server exposes `list_departments`, `list_locations`, and `list_employees` to let your agent build clear organizational charts on the fly. You get a live snapshot of where your team works and how they are grouped. When you need to verify if a new hire is assigned to the correct office, Claude Desktop queries these endpoints to verify the details. It bypasses the slow Gusto admin dashboard entirely, giving you the facts in seconds.

Check benefits and time-off policies

The `list_benefits` and `list_time_off_policies` tools let your agent answer employee questions about coverage and leave directly. You do not have to dig through policy PDFs or HR handbooks to find active programs. Claude Desktop reads the enrollment data and active rules to summarize what is available for specific teams. This turns your chat interface into a quick reference tool for company perks and time-off structures.

Setup guide

Set up Gusto MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Gusto MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Gusto MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under gusto-mcp.

json

{
  "mcpServers": {
    "gusto-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Gusto. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Gusto now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Gusto MCP in Claude Desktop

Open your `claude_desktop_config.json` file and add the server under the `mcpServers` key. Provide the command and arguments for the stdio transport, save the file, and fully restart the app. You will see a hammer icon indicating the tools are active.

Yes, you can connect remote servers to the web version at claude.ai. Go to Settings, open the Integrations tab, and add your remote MCP server URL. This lets your agent access the HR data from any browser.

The current tools like `list_payrolls` and `get_payroll` are designed for reading and auditing data. You can inspect historical runs, verify totals, and check employee allocations, but you cannot execute final payments through these specific tools.

The `list_companies` tool returns all organizations associated with your account. Your agent can switch contexts by using `get_company` to fetch details for the specific entity you want to audit.

This integration touches sensitive payroll totals, tax data, and employee home addresses. The Vinkius sandbox runs each session in an isolated V8 container, ensuring your HR records are never cached, stored, or exposed to third parties.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript