@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

1. Log into your Emplyx admin panel
2. Go to Settings > API Keys
3. 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:

1. Starts with emplyx_live_
2. Has not been revoked
3. Has the required scopes

"Binary not found"

The package includes pre-compiled binaries. If missing:

1. Reinstall the package
2. 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: [email protected]