MCP.so
Sign In

Darwinbox HRMS MCP Server

@prithvidbox

About Darwinbox HRMS MCP Server

MCP server for Darwinbox HRMS

Basic information

Category

Other

License

MIT license

Runtime

node

Transports

stdio

Publisher

prithvidbox

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "darwinbox": {
      "command": "node",
      "args": [
        "path/to/darwinbox-server/build/index.js"
      ],
      "env": {
        "DARWINBOX_DOMAIN": "",
        "DARWINBOX_CLIENT_ID": "",
        "DARWINBOX_CLIENT_SECRET": "",
        "DARWINBOX_GRANT_TYPE": "",
        "DARWINBOX_CODE": "",
        "DARWINBOX_DATASET_KEY": ""
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Darwinbox HRMS MCP Server?

A Model Context Protocol (MCP) server for interacting with the Darwinbox HRMS API. It provides standardized tools for managing employee data, attendance, and leave management, enabling AI assistants to perform HR operations.

How to use Darwinbox HRMS MCP Server?

Clone the repository, install dependencies (npm install), and build (npm run build). Configure your MCP client (Claude Desktop, Cline, or Cursor) with the required environment variables: DARWINBOX_DOMAIN, DARWINBOX_CLIENT_ID, DARWINBOX_CLIENT_SECRET, DARWINBOX_GRANT_TYPE, DARWINBOX_CODE, and DARWINBOX_DATASET_KEY. The server then exposes tools authenticated via OAuth 2.0.

Key features of Darwinbox HRMS MCP Server

  • Employee management: get, update, add, and deactivate employees.
  • Download personal documents and upload profile attachments.
  • Get employee history, position master data, and forms data.
  • Attendance management: get monthly/daily attendance and roster.
  • Record and backdate attendance punches.
  • Leave management: approve leaves, get balance, balance, import leaves.

Use cases of Darwinbox HRMS MCP Server

  • AI assistants performing employee data lookups or updates.
  • Automated attendance tracking and punch recording.
  • Streamlined leave approval workflows and balance inquiries.

FAQ from Darwinbox HRMS MCP Server

What is the purpose of this server?

It provides an MCP interface to the Darwinbox HRMS API, allowing AI clients to manage employee data, attendance, and leaves programmatically.

What are the runtime dependencies?

Node.js and npm are required. The server is built from TypeScript source using npm run build.

How does authentication work?

The server uses OAuth 2.0 and automatically handles token acquisition, management, and renewal using the provided credentials and grant type.

Where does employee data reside?

Data is stored in the Darwinbox HRMS system and accessed via its API; the server does not store data locally.

What transport does the server use?

Configuration examples for Claude Desktop, Cline, and Cursor show the server runs as a local subprocess (stdio), standard for MCP servers.

Comments

More Other MCP servers