How do I use keka-mcp-server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@keka-mcp-server List employees hired this month" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

keka-mcp-server

by huebnermarketing

Overview Schema Related Servers Score Discussions

TypeScript

Remote

keka-mcp-server

MCP server for the Keka HRM API, built for White Label IQ (WLIQ).

Exposes 14 tools covering Keka's core modules so Claude (or any MCP client) can query and act on HR data.

Tools

HRIS

Tool	Description
`keka_list_employees`	List employees with filters (status, search, probation, etc.)
`keka_get_employee`	Get full details for a single employee by ID
`keka_list_departments`	List all departments
`keka_list_job_titles`	List all job titles
`keka_list_groups`	List all groups/teams

Leave Management

Tool	Description
`keka_list_leave_types`	List configured leave types (Annual, Sick, etc.)
`keka_list_leave_requests`	List leave requests with date/employee filters
`keka_create_leave_request`	Submit a new leave request for an employee
`keka_get_leave_balances`	Get leave balance breakdown per employee

Attendance

Tool	Description
`keka_get_attendance`	Get attendance records (clock-in/out, hours, status)

Payroll

Tool	Description
`keka_list_pay_groups`	List payroll groups
`keka_list_pay_bands`	List salary pay bands
`keka_list_salaries`	List employee salaries (CTC, pay group)

Recruitment (Keka Hire)

Tool	Description
`keka_list_jobs`	List job openings
`keka_list_candidates`	List candidates for a specific job

PSA

Tool	Description
`keka_list_psa_clients`	List PSA clients
`keka_list_psa_projects`	List PSA projects

Related MCP server: Keka MCP Server

Setup

1. Get Keka API credentials

In your Keka admin portal:

Go to Settings → Integrations → API
Create a new API access key
Note down: Client ID, Client Secret, API Key

2. Install dependencies

npm install

3. Build

npm run build

4. Environment variables

Variable	Required	Description
`KEKA_BASE_URL`	✅	Your Keka tenant URL, e.g. `https://yourcompany.keka.com`
`KEKA_CLIENT_ID`	✅	OAuth2 Client ID from Keka admin
`KEKA_CLIENT_SECRET`	✅	OAuth2 Client Secret
`KEKA_API_KEY`	✅	API key from Keka admin
`KEKA_EMPLOYEE_ID`	Optional	Your own Keka employee ID — used as `requestedBy` when applying leave on behalf of others
`KEKA_SANDBOX`	Optional	Set to `true` to use `kekademo.com` sandbox auth
`TRANSPORT`	Optional	`stdio` (default) or `http`
`PORT`	Optional	HTTP port when `TRANSPORT=http` (default: `3000`)

Claude Desktop integration (stdio)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "keka": {
      "command": "node",
      "args": ["/path/to/keka-mcp-server/dist/index.js"],
      "env": {
        "KEKA_BASE_URL": "https://yourcompany.keka.com",
        "KEKA_CLIENT_ID": "your-client-id",
        "KEKA_CLIENT_SECRET": "your-client-secret",
        "KEKA_API_KEY": "your-api-key",
        "KEKA_EMPLOYEE_ID": "your-employee-uuid"
      }
    }
  }
}

HR Skill Prompt (optional)

Copy the contents of keka-hr-skill.md into Claude Desktop's Custom Instructions (Settings → Custom Instructions). This teaches Claude how to handle Keka operations smoothly — resolving names to IDs, always including required fields, checking balances before applying leave, etc.


## HTTP mode (remote deployment)

```bash
TRANSPORT=http \
KEKA_BASE_URL=https://yourcompany.keka.com \
KEKA_CLIENT_ID=xxx \
KEKA_CLIENT_SECRET=xxx \
KEKA_API_KEY=xxx \
node dist/index.js

Health check: GET http://localhost:3000/health MCP endpoint: POST http://localhost:3000/mcp

Authentication

Keka uses a custom OAuth2 flow (grant_type=kekaapi). The server:

Fetches a Bearer token on first request
Caches the token in memory
Auto-refreshes 2 minutes before expiry (tokens last 24 hours)

Rate Limits

Keka enforces 50 requests per minute. The server returns a clear error message if this limit is hit.

Development

# Watch mode (no build required)
npm run dev

# Build
npm run build

# Start production
npm start

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/huebnermarketing/keka-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server