Skip to main content
Glama
hakeemrabiuDFW

Tanda Workforce MCP Server

by hakeemrabiuDFW
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Tanda Workforce MCP Server

A production-ready MCP (Model Context Protocol) server for integrating Tanda Workforce API with AI assistants like Claude. Features OAuth2 authentication and comprehensive workforce management tools.

Features

  • OAuth2 Authentication - Secure authentication flow with Tanda

  • MCP Protocol Support - Full JSON-RPC 2.0 implementation

  • 25+ Workforce Tools - Users, schedules, timesheets, leave, clock-in/out, and more

  • Production Ready - Docker support, rate limiting, security headers, logging

  • TypeScript - Fully typed codebase

Quick Start

1. Clone and Install

git clone https://github.com/hakeemrabiuDFW/Tanda-Workforce-MCP-Server.git cd Tanda-Workforce-MCP-Server npm install

2. Configure Environment

cp .env.example .env # Edit .env with your Tanda OAuth credentials

Required environment variables:

  • TANDA_CLIENT_ID - Your Tanda OAuth client ID

  • TANDA_CLIENT_SECRET - Your Tanda OAuth client secret

  • TANDA_REDIRECT_URI - OAuth callback URL (e.g., http://localhost:3000/auth/callback)

  • SESSION_SECRET - Random 32+ character string

  • JWT_SECRET - Random 32+ character string

3. Run

# Development npm run dev # Production npm run build npm start # Docker docker-compose up -d

Adding to Claude

Claude Desktop Configuration

Add to your Claude config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{ "mcpServers": { "tanda-workforce": { "url": "https://your-server.com/mcp", "headers": { "Authorization": "Bearer YOUR_JWT_TOKEN" } } } }

Getting a JWT Token

  1. Navigate to https://your-server.com/auth/login

  2. Authenticate with your Tanda account

  3. Copy the returned JWT token

API Endpoints

Endpoint

Method

Description

/

GET

Server info

/health

GET

Health check

/docs

GET

API documentation

/auth/login

GET

Start OAuth flow

/auth/callback

GET

OAuth callback

/api/authenticate

POST

Exchange code for token

/mcp

POST

MCP protocol endpoint

Available Tools

User Management

  • tanda_get_current_user - Get current user profile

  • tanda_get_users - List all employees

  • tanda_get_user - Get specific user details

Scheduling

  • tanda_get_schedules - Get scheduled shifts

  • tanda_create_schedule - Create new shift

  • tanda_update_schedule - Update shift

  • tanda_delete_schedule - Delete shift

  • tanda_publish_schedules - Publish schedules

Timesheets

  • tanda_get_shifts - Get worked shifts

  • tanda_get_timesheets - Get timesheets

  • tanda_approve_shift - Approve shift

  • tanda_approve_timesheet - Approve timesheet

Leave Management

  • tanda_get_leave_requests - Get leave requests

  • tanda_create_leave_request - Create leave request

  • tanda_approve_leave - Approve leave

  • tanda_decline_leave - Decline leave

  • tanda_get_leave_balances - Get leave balances

Clock In/Out

  • tanda_clock_in - Clock operations

  • tanda_get_clock_ins - Get clock records

Organization

  • tanda_get_departments - List departments

  • tanda_get_locations - List locations

  • tanda_get_qualifications - List qualifications

Costs & Awards

  • tanda_get_roster_costs - Get labor costs

  • tanda_get_award_interpretation - Get pay calculations

Docker Deployment

# Build and run docker-compose up -d --build # View logs docker-compose logs -f # Stop docker-compose down

Development

# Install dependencies npm install # Run in development mode npm run dev # Build for production npm run build # Run linter npm run lint

Project Structure

├── src/ │ ├── auth/ # OAuth and authentication │ │ ├── middleware.ts │ │ └── oauth.ts │ ├── config/ # Environment configuration │ │ └── environment.ts │ ├── mcp/ # MCP protocol handlers │ │ ├── handler.ts │ │ └── tools.ts │ ├── server/ # Express server setup │ │ └── app.ts │ ├── tanda/ # Tanda API client │ │ ├── client.ts │ │ └── types.ts │ ├── utils/ # Utilities │ │ └── logger.ts │ └── index.ts # Entry point ├── Dockerfile ├── docker-compose.yml ├── DEPLOYMENT.md # Full deployment guide └── package.json

Documentation

See DEPLOYMENT.md for comprehensive deployment instructions including:

  • OAuth setup with Tanda

  • Cloud deployment guides (AWS, GCP, Railway)

  • Testing procedures

  • Troubleshooting

License

MIT License - see LICENSE file

Author

hakeemrabiuDFW

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

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/hakeemrabiuDFW/Tanda-Workforce-MCP-Server'

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