@emplyx/mcp-server

@emplyx/mcp-server

MCP (Model Context Protocol) server for Emplyx HR Platform. Exposes 346+ HR management tools to AI assistants like Claude.

Installation

npm install -g @emplyx/mcp-server
# or use with npx
npx @emplyx/mcp-server

Configuration

1. Get an API Key

• Log into your Emplyx admin panel
• Go to Settings > API Keys
• Create a new API key with the required scopes

2. Configure Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "emplyx": {
      "command": "npx",
      "args": ["@emplyx/mcp-server"],
      "env": {
        "EMPLYX_API_KEY": "emplyx_live_your_key_here"
      }
    }
  }
}

Configuration File Location

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Environment Variables

Variable	Required	Description
EMPLYX_API_KEY	Yes	Your Emplyx API key (format: emplyx_live_xxx)
EMPLYX_API_URL	No	API endpoint (default: production)

Available Tools

The server exposes tools based on your API key's scopes:

Scope	Tools
employees:read	Search employees, get employee details
employees:write	Create, update, deactivate employees
schedules:read	List shifts, view schedules
schedules:write	Assign shifts, manage schedules
absences:read	View absence requests, balances
absences:write	Create/approve/reject absence requests
clockings:read	View time entries, timelines
clockings:write	Create corrections, approve requests
documents:read	List documents
documents:write	Upload, manage documents
*	Full access to all 346+ tools

Example Usage

Once configured, you can ask Claude things like:

• "Show me employees who are on vacation this week"
• "Create an absence request for Juan from Feb 1-5"
• "What are the active shifts in the company?"
• "Search for employees named Maria"

Supported Platforms

• macOS (arm64, x64)
• Linux (x64, arm64)
• Windows (x64)

Troubleshooting

"Invalid API Key"

Ensure your API key:

• Starts with emplyx_live_
• Has not been revoked
• Has the required scopes

"Binary not found"

The package includes pre-compiled binaries. If missing:

• Reinstall the package
• Check if your platform is supported

License

MIT - See LICENSE for details.

Support

• Documentation: https://docs.emplyx.com/mcp
• Issues: https://github.com/emplyx/mcp-server/issues
• Email: [e-mail]