How to Use the WebHR MCP in Claude

Q: How do I check WebHR leave history using Claude Desktop?

Just run the listleaverequests tool. It gives you a detailed record of every employee's time off, which is critical for HR audits.

Q: Can WebHR list all departments with Claude Desktop?

Yes. The server has the listcompanydepartments function. You can pull a clean list like Sales and Engineering to help categorize staff or roles.

Q: Where can I find job openings in WebHR using Claude Desktop?

You use the listjobpostings tool. This pulls all currently active jobs that need filling across the organization, giving you a clear view of recruiting needs.

Q: Does WebHR store office locations data with Claude Desktop?

Yep. The server has listofficelocations. It lets your agent grab every physical location tied to the company structure.

Q: What specific employee details does WebHR touch when using Claude Desktop?

It touches general personnel data through tools like getemployeedetails and basic organizational structure info via listemployees. This covers names, roles, department affiliation, etc.

Get HR data and run local scripts right from Claude Desktop.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect WebHR MCP to Claude Desktop

Create your Vinkius account to connect WebHR 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 WebHR with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

View Employee Roster Details with MCP Server

You can get a full roster of staff using `list_employees`, or dig into specific personnel records with `get_employee_details`. This lets you pull detailed info about any employee, regardless of their role. Need to know how people are organized? Check out the departments via `list_company_departments` and find out which company offices exist using `list_office_locations`.

Review Attendance Records in Claude Desktop

The tool `list_attendance_logs` gives you a complete record of every clock-in and clock-out event. You can also get an aggregated summary of attendance metrics using `get_attendance_summary`. This is solid for payroll or compliance checks. When staff take time off, the server tracks it all. Use `list_leave_requests` to check employee leave history against the available types listed in `list_available_leave_types`.

Manage Job Candidates and Open Positions

Want to see who applied for open roles? Run `list_job_candidates` to pull applicant data. For current hiring needs, you can check existing job openings with `list_job_postings`. This handles the whole recruitment pipeline. Furthermore, if the company has internal moves happening, you can list internal requisitions using `list_job_requests`, or see which specific departments need new talent.

Setup guide

Set up WebHR 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 WebHR 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 WebHR 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 webhr-mcp.

json

{
  "mcpServers": {
    "webhr-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 WebHR. 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 WebHR 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 WebHR MCP in Claude Desktop

Just run the `list_leave_requests` tool. It gives you a detailed record of every employee's time off, which is critical for HR audits.

Yes. The server has the `list_company_departments` function. You can pull a clean list like Sales and Engineering to help categorize staff or roles.

You use the `list_job_postings` tool. This pulls all currently active jobs that need filling across the organization, giving you a clear view of recruiting needs.

Yep. The server has `list_office_locations`. It lets your agent grab every physical location tied to the company structure.

It touches general personnel data through tools like `get_employee_details` and basic organizational structure info via `list_employees`. This covers names, roles, department affiliation, etc.

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