
Connect SmartHR to ChatGPT, Claude and Gemini
Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Query your entire employee database using natural language.
Developed, maintained, and hosted by Vinkius.
MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED
Waiting for input…
Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.
Your AI does the work. We keep it safe and sound.
No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.
Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

Each Connector runs inside its own sealed environment.
Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.
One switch stops every agent. Instantly.
One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.
Spending limits that pause instead of surprise.
Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.
Three controls, built into the layer your AI connects through.
Curated set · 8 capabilities
We ship only the actions that matter.
01-04
4 capabilities in this set.
Part of 8 available through SmartHR.
- 01
Get crew details
This capability pulls the full profile for a specific employee.
- 02
List crews
Use this to get a complete roster of every employee in SmartHR.
- 03
List departments
This capability returns a list of all organizational departments.
- 04
List positions
Get a list of all job roles and positions within the company.
05-08
4 capabilities in this set.
Part of 8 available through SmartHR.
- 05
List establishments
This capability retrieves a list of all physical office locations and business establishments.
- 06
List crew dependents
Use this to see the dependents registered to a specific employee.
- 07
List employment types
This capability provides a list of all available employment types.
- 08
List payrolls
Get access to employee payroll records for auditing or review.
Real work
What teams actually run
Rapid Staffing Checks
Ask your agent for a list of all employees in a specific department to check headcount.
Payroll Auditing
Query payroll records to verify compensation details for specific time periods.
Onboarding Support
Quickly find the employment type and position details for new hires.
Facility Management
Get a list of all company establishments to coordinate office-based tasks.
Automate a task
Put SmartHR to work on one thing.
Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.
One connector, every AI
SmartHR works with the most popular AI clients.
These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.
Claude
ChatGPT
Gemini
Perplexity
Grok
Microsoft Copilot
Cursor
VS Code
Windsurf
JetBrains
Cline
LangChain
Vercel AI SDK
Lovable
Z.ai
Raycast
Qwen Code
Kimi Code
Le ChatBuilding your own app? The connector is yours to use.
You don't need a client to put SmartHR to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.
Observed, not estimated
906ms average. Fast in production.
SmartHR is checked daily against the live service.
- Fastest day
- 657ms
- Slowest day
- 1180ms
- 14-day trend
- Stable0%
Connect your client
One URL. Every client.
Activate the Connector, copy your link, and paste it into the client you already use. 8 capabilities arrive ready to run.
Preview access · not provider authentication
The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of SmartHR, so you can see the experience inside your AI.
It does not authenticate your account with SmartHR. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.
SmartHR Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_sLHuomQKWLgonmqoMlVmmQKwVfYLP3BsOZeKtZIy/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — SmartHR capabilities are ready to use.
{
"mcpServers": {
"smarthr-mcp": {
"url": "https://edge.vinkius.com/vk_preview_sLHuomQKWLgonmqoMlVmmQKwVfYLP3BsOZeKtZIy/mcp"
}
}
}
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Step-by-step instructions for each client are in the guide. How to connect
Guided setup for Claude? Set up SmartHR in Claude and other AIs
Who it's for
Built for the work SmartHR owners hand off.
This MCP is built for professionals who need quick, conversational access to human resources data without manual navigation.
- 01
HR Managers
They use the agent to audit payroll accounts or check employee dependents via chat.
- 02
Department Leads
They request lists of active job positions and team members to manage their staff.
- 03
Security Teams
They verify office locations and active employee sublists for physical security audits.
FAQ
Questions SmartHR owners ask.
- 01
How do I connect SmartHR to my AI client?
You subscribe to the MCP on Vinkius and enter your SmartHR credentials, including your Access Token and Subdomain. Once connected, your AI client can immediately use the capabilities.
- 02
Which AI clients can I use with this MCP?
You can use any MCP-compatible client, such as Claude, Cursor, or Windsurf.
- 03
Can I access sensitive payroll information?
Yes, the MCP includes capabilities to query payroll records and employee compensation details securely.
- 04
Do I need to stay logged into the SmartHR website?
No, once the MCP is connected via Vinkius, your AI agent communicates with the SmartHR API directly.
- 05
Can I see my employees' dependents?
Yes, you can use the specific capability designed to list dependents for any given employee.
- 06
Is it safe to expose my company's payrolls to the AI?
Yes. This connector runs entirely on your local machine or trusted enclave natively. No employee data, payload information or generated queries are routed to our servers—your API interactions occur directly from your environment straight to SmartHR's endpoints.
- 07
Can the agent calculate average payroll over time automatically?
Absolutely. Just prompt your agent: 'List all payrolls from Q2, and display the average distribution'. The agent will call the list_payrolls endpoint, retrieve the raw figures, do the mathematical operation independently in context, and present you a very clear table or markdown summary.
- 08
How do I look up which internal department an employee works for?
You don't need to specify the exact capability. You can simply ask: 'What department is crew member [Name] in?'. Your AI will automatically use the list_crews capability and cross reference the results with list_departments to formulate a correct response.
Explore
More in Human Resources
UKG Pro AI Connector
Manage HR data, employee profiles, and payroll via UKG Pro.
ViewChartHop AI Connector
Manage people operations and organizational data via ChartHop — track jobs, people, and headcount planning dir
ViewKeyPay AI Connector
Manage payroll, employees, and pay runs via the Employment Hero Payroll (KeyPay) API.
ViewTalexio AI Connector
Manage HR and payroll for Mediterranean businesses with employee onboarding, leave tracking, and local complia
View
Suggestions
Lamha AI Connector
Build AI chatbots for Arabic-speaking audiences with natural language understanding designed for Middle Easter
ViewShift Swap Planner AI Connector
Matches requested shift swaps using employee availability, skills, and labor limits.
ViewGusto AI Connector
Manage employees, run payroll, view benefits and time-off policies — HR automation for AI agents.
ViewDOL (Department of Labor) AI Connector
Access US Department of Labor data including OSHA inspections, MSHA safety records, and wage compliance direct
View
Connect SmartHR to Claude, Cursor, ChatGPT & more
