MCP server for AFKBot PTO management — file time-off requests from any MCP client.
┌──────────────┐ stdio ┌──────────────┐ HTTPS ┌──────────────┐
│ MCP Client │◄──────────────►│ afkbot-mcp │◄────────────►│ AFKBot API │
│ (Claude, etc)│ │ MCP Server │ Bearer JWT │ (Azure ACA) │
└──────────────┘ └──────────────┘ └──────┬───────┘
│
┌────────┬───────┼────────┐
│ │ │ │
Float Outlook Autotask Rootly
AFKBot orchestrates PTO requests across Float, Outlook Calendar, Autotask, and Rootly. This MCP server wraps its REST API so any MCP-compatible client can file and manage time-off requests.
| Variable | Required | Description |
|---|---|---|
AZURE_TENANT_ID |
Yes | Azure AD tenant ID (d92c73a4-ccc2-4277-8c5d-73c2849adfa4) |
AZURE_CLIENT_ID |
Yes | Your MCP server's app registration client ID |
AZURE_CLIENT_SECRET |
Yes | Your MCP server's app registration client secret |
AFKBOT_API_URL |
No | AFKBot API URL (defaults to production) |
AFKBOT_APP_CLIENT_ID |
No | AFKBot Easy Auth client ID (defaults to production) |
npm ci
npm run build
node dist/index.jsdocker compose up --build{
"mcpServers": {
"afkbot": {
"command": "node",
"args": ["/path/to/afkbot-mcp/dist/index.js"],
"env": {
"AZURE_TENANT_ID": "d92c73a4-ccc2-4277-8c5d-73c2849adfa4",
"AZURE_CLIENT_ID": "your-app-client-id",
"AZURE_CLIENT_SECRET": "your-app-client-secret"
}
}
}
}File a new PTO request.
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_email |
string | Yes | Employee email address |
request_type |
string | Yes | full_day or partial_day |
start_date |
string | Yes | Start date (YYYY-MM-DD) |
end_date |
string | No | End date (defaults to start_date) |
start_time |
string | No | Start time for partial day (HH:MM) |
end_time |
string | No | End time for partial day (HH:MM) |
details |
string | No | Reason or notes |
List PTO requests with optional filters.
| Parameter | Type | Required | Description |
|---|---|---|---|
status |
string | No | pending, approved, declined, or all |
employee_email |
string | No | Filter by employee |
limit |
number | No | Max results (default: 25) |
offset |
number | No | Pagination offset |
Get details of a specific request.
| Parameter | Type | Required | Description |
|---|---|---|---|
request_id |
string | Yes | The PTO request ID |
Cancel a pending or approved request.
| Parameter | Type | Required | Description |
|---|---|---|---|
request_id |
string | Yes | The PTO request ID |
reason |
string | No | Reason for cancellation |
View who's out on a given date range.
| Parameter | Type | Required | Description |
|---|---|---|---|
start_date |
string | Yes | Start date (YYYY-MM-DD) |
end_date |
string | No | End date (defaults to start_date) |
This MCP server authenticates to AFKBot using Azure AD client credentials. You need to create an app registration:
-
Create an App Registration in Azure AD (Entra ID)
- Go to Azure Portal → Entra ID → App registrations → New registration
- Name:
afkbot-mcp(or your choice) - Supported account types: Single tenant
-
Create a Client Secret
- In the app registration → Certificates & secrets → New client secret
- Copy the secret value
-
Grant API Permissions
- In the app registration → API permissions → Add a permission
- Select "APIs my organization uses" → search for AFKBot (
17963178-bee5-4738-82a3-088e739bb95b) - Add the appropriate permissions
- Grant admin consent
-
Set Environment Variables using the values from the app registration
This is part of the WYRE Technology MCP server suite:
- autotask-mcp — Kaseya Autotask PSA integration
- afkbot-mcp (this repo) — PTO management via AFKBot
MIT — Copyright (c) 2025 Aaron Sachs