SmartHR Connector for AI agents.
8 live capabilities
Query employee records and payroll data from your SmartHR workspace.
Waiting for input…
Why people use SmartHR
SmartHR : Stop Hunting Through HR Portals for Employee Data
With this Connector, you just ask your agent. It pulls the list of establishments and the crew data in one go. You get the count in seconds without ever opening a browser tab.
What Vinkius changes
You get instant, natural language access to your entire HR database without the manual clicking.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Checking dependents for health insurance
An HR admin needs to verify if a new hire has dependents.
- Real-world use case 02
Mapping the Engineering department
A manager needs to see the hierarchy of the tech team.
- Real-world use case 03
Auditing regional payroll
The finance team needs to see payroll records for the Tokyo branch.
Complete set · 8capabilities
The complete SmartHR capability set.
These are the exact actions your AI can choose when you ask it to work with SmartHR.
01—04
4 capabilities in this set.
Part of 8 available through SmartHR.
- 01 Capability
List crews
Get a full list of all employees. Use this to pull a complete roster for any report.
- 02 Capability
Get crew details
Pull deep profile information for a single person. It gives you the specifics on a specific contract.
- 03 Capability
List departments
View your organization's departments. This helps you see the high-level structure of the company.
- 04 Capability
List positions
See every job role in your company. It helps you understand the variety of positions available.
05—08
4 capabilities in this set.
Part of 8 available through SmartHR.
- 05 Capability
List employment types
Get a breakdown of all employment categories. Use this to see the mix of full-time and contract staff.
- 06 Capability
List payrolls
Access employee payroll records. This is useful for auditing compensation across the organization.
- 07 Capability
List establishments
Find all physical business locations. Use it to see where your teams are actually based.
- 08 Capability
List crew dependents
See the dependents for a specific employee. This helps with benefits and insurance inquiries.
Set up in minutes
One URL. Then ask SmartHR to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use SmartHR from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_sLHuomQKWLgonmqoMlVmmQKwVfYLP3BsOZeKtZIy/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it SmartHR, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable SmartHR for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_sLHuomQKWLgonmqoMlVmmQKwVfYLP3BsOZeKtZIy/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the SmartHR URL.
- Step 03
Save and start
Save the connection and enable SmartHR in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"smarthr": {
"url": "https://edge.vinkius.com/vk_preview_sLHuomQKWLgonmqoMlVmmQKwVfYLP3BsOZeKtZIy/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using SmartHR
Open Agent mode in chat and ask: "Using SmartHR, help me...". 8 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"smarthr": {
"url": "https://edge.vinkius.com/vk_preview_sLHuomQKWLgonmqoMlVmmQKwVfYLP3BsOZeKtZIy/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using SmartHR
Ask Copilot: "Using SmartHR, help me...". 8 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"smarthr": {
"url": "https://edge.vinkius.com/vk_preview_sLHuomQKWLgonmqoMlVmmQKwVfYLP3BsOZeKtZIy/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using SmartHR
Open Cascade and ask: "Using SmartHR, help me...". 8 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"smarthr": {
"url": "https://edge.vinkius.com/vk_preview_sLHuomQKWLgonmqoMlVmmQKwVfYLP3BsOZeKtZIy/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using SmartHR
Ask Cline: "Using SmartHR, help me...". 8 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add smarthr --transport http "https://edge.vinkius.com/vk_preview_sLHuomQKWLgonmqoMlVmmQKwVfYLP3BsOZeKtZIy/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using SmartHR
Ask Claude: "Using SmartHR, show me...". 8 tools are ready
Where the request belongs
Work SmartHR can move forward.
HR managers who are tired of manual data pulls, department heads needing quick team stats, and security teams auditing office locations.
HR Administrator
Auditing payroll and checking employee dependents during onboarding or benefits review on a Tuesday afternoon.
Department Lead
Getting a quick headcount or list of job positions for team planning without leaving their chat client.
Facilities Manager
Checking office locations and establishment details for logistics and site audits.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsBambooHR
Human Resources management platform. organize employee data, track time off, and audit HR workflows via AI.
Oyster
Manage global HR, payroll, and compliance via Oyster. list engagements, track expenses, and manage time-off requests directly from any AI agent.
Gusto
Manage employees, run payroll, view benefits and time-off policies. HR automation for AI agents.
WebHR
Manage employees, attendance, and recruitment on WebHR with AI agents.
BrioHR
Orchestrate BrioHR management. retrieve employee profiles, monitor leave, and integrate claim reports directly from any AI agent.
Workday
Manage workers, payroll data, org structures, and HR workflows on Workday. the enterprise HCM platform.
Bring your own AI
Change the model, client or framework. Keep SmartHR connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about SmartHR.
The practical details behind the request, access and result.
Can the SmartHR MCP access my payroll data?
Yes, it can query your payroll ledgers to help you audit compensation scaling or check historical records for specific employees.
Does the SmartHR MCP show my office locations?
Yes, it lists all physical business establishments and office locations registered in your SmartHR workspace.
Can I use SmartHR MCP to update employee info?
No, this Connector is for reading and querying data. You'll still need to use the SmartHR web platform to create or edit employee records.
How do I connect my SmartHR account?
Just subscribe to the Connector on Vinkius and add your SmartHR Access Token and Subdomain to your AI client's configuration.
Is my employee data safe with this Connector?
Yes, the Connector uses your specific access token to securely query your data without ever storing your credentials.
Can I see department hierarchies with SmartHR MCP?
Yes, it can list all organizational departments and job positions so you can understand your company's structure easily.
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.
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.
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.
One connection away
Give your agent a direct line to SmartHR.
Connect SmartHR once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available